Onboarding documentation

• Welcome
• Get started
• Content-development tools
• Communication
• People
• Microlearning Specialist (MLS) tasks and responsibilities
• SME Writer responsibilities
• Who's who on the team
• Project information
• The publishing phase
• The development phase
• The design phase
• Introduction to microlearning projects
• Create microlearning modules
• Prepare VSC and GitHub
• Resources
• Pre-publish automatic checks
• Markdown guidelines and examples
• Instructional design review
• Module-writing guidance
• Module content overview
• Create markdown files
• Compliance check

Content must meet the PR (Pull request) quality criteria in the Microsoft Learn Contributor Guide .

Tip: Download the PDF version of the Microsoft Learn Contributor Guide if you can’t access the online guide using links on this and other pages. This is usually caused because of outdated or missing v-dash credentials.

Hand off to PjM

Once all units of a module have an Acrolinx score of 80 or higher and pass all build-validation tests, the MLS hands off the module to the PjM, who then submits it to Microsoft for their publishing process:

1. The PjM adds “#sign-off” to the comments in the pull request.

   Note: any words that are spelled correctly (such as terms) but were flagged as misspellings by Acrolinx are added to the pull request at this point.

2. The pull request gets assigned to the appropriate Microsoft reviewer.

   

3. The Microsoft Reviewer responds with feedback in comments.

   

4. The PjM resolves the issues raised in the Microsoft reviewer’s comments.
5. The PjM comments and adds “#sign-off” in comments in the pull request.