patridge / learn-metadata-tool

Chrome extension for Microsoft Learn folks to find content maintainers and GitHub content pages.
https://chrome.google.com/webstore/detail/microsoft-learn-maintenan/kagphmnlicelfcbbhhmgjcpgnbponlda
MIT License
2 stars 0 forks source link

Learn Maintenance Tool

Determine the author of a given Microsoft Learn or Microsoft Docs page. And quickly navigate to the content in GitHub to propose edits. This tool was created for the Microsoft Learn content team to help triage user-reported feedback to the right maintainer, but anyone is welcome to use it if it helps them.

Screenshot of the Microsoft Learn Maintenance Tool Chrome extension showing a page's author, date, and edit link metadata loaded.

Features

View Microsoft Learn and Microsoft Docs page metadata

When you are viewing a Microsoft Learn or Microsoft Docs content page, clicking the Learn Maintenance Tool extension will show a pop-up with useful page metadata fields, each with a copy button to allow for easy pasting where you need it. The pop-up also includes clickable links to open the YAML and Markdown pages for editing directly in GitHub.

This is the information currently being extracted:

View Microsoft Learn content page from Azure DevOps customer feedback work items

When you are viewing a customer feedback work item for a Microsoft Learn page the Learn Maintenance Tool extension will show a pop-up with some useful metadata fields and a link to view other open feedback for this unit and parent module as well as any customer feedback rating verbatims. This way, you can tackle several work items in a single maintenance session.

Optional pop-up link

If you regularly need to go to a page as part of your maintenance efforts, you can have the Learn Maintenance Tool pop-up offer a link to that page to have it handy at all times.

Screenshot of the Microsoft Learn Maintenance Tool pop-up showing a custom link, highlighted, with a title of "Cat Overflow".

This link is hidden by default, but can be enabled and configured in the extension options page.

  1. Right-click the extension button in your browser and select Options. You can also find an Extension options link to select from the extension details.

    Screenshot of the Microsoft Learn Maintenance Tool Chrome extension menu showing the Options entry highlighted.

  2. Within the options, first enable the link by selecting the Show link button and confirming you want to enable it. (To disable it when it is shown, select the Hide link button and confirm.)

  3. To customize the link name or URL the link navigates to, edit the Set link label and Set link URL fields and select the Set custom link button.

The next time you open the extension pop-up your link should be shown and will open in a new tab.

Installation

If you are using Google Chrome or the Chromium-based Microsoft Edge, you can install the Microsoft Learn maintenance tool extension to allow retrieving Learn page metadata from the browser toolbar.

Google Chrome

Installation on Google Chrome works as you would install any other Chrome extension found on the Chrome Web Store.

  1. Visit the Microsoft Learn maintenance tool extension page on the Chrome Web Store.
  2. Click the Add to Chrome button on the extension page. Screenshot of Microsoft Learn maintenance tool Chrome extension page
  3. Confirm the extension install by clicking the Add extension button from the resulting pop-up. Screenshot of pop-up prompt confirming Chrome extension install

Microsoft Edge

For Microsoft Edge, you'll first need to allow installing extensions from other stores. You can do this from the extension page on the Chrome Web Store above. Edge will put a header in place to guide you to allow Chrome Web Store extensions.

  1. Click the Allow extensions from other stores button from the header in Edge. Screenshot of the top bar added to the Chrome Web Store by Microsoft Edge stating, "You can now add extensions from the Chrome Web Store to Microsoft Edge"
  2. Confirm enabling other stores by clicking the Allow button from the resulting pop-up. Screenshot of the pop-up alert shown when asking Edge to allow extensions from other stores

[!NOTE] You can also toggle this setting from the Extensions page. Expand the left-hand menu, if needed, and toggle the Allow extensions from other stores option.

  1. Visit the Microsoft Learn maintenance tool extension page on the Chrome Web Store.
  2. Click the Add to Chrome button on the extension page.
  3. Confirm the extension install by clicking the Add extension button from the resulting pop-up. Screenshot of pop-up prompt confirming Chrome extension install

Release notes

v0.7

v0.6

Roadmap

Here are the current plans for upcoming releases. These are definitely subject to change as this project develops or evolves.

v0.8+: Customization

Future plans and suggestions

You can follow along with planned development efforts by looking at the open GitHub issues with the enhancement tag. If you have a feature or suggestion you want to propose, submit your own enhancement request on GitHub.