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

Templates and instructions

Here are links to the templates we use for Design docs (which become Module docs).

Important! Please do not edit the documents in place! Save a copy on your computer to use.

• Microlearning combined template.dotx
• Microlearning combined template – instructions
• Microlearning combined template - supplementary material (used after the design phase)

Note: If you prefer to access this and other files in a library, visit this library and set the view to Instructional Design.

Additional Resources

Here are some additional resources to help you learn about creating microlearning modules.

Writing resources

• 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.

• Authoring guidelines
• Microsoft Writing Style Guide, Top 10 tips for Microsoft style and voice

Markdown references

• WayPoint Ventures:Markdown syntax guide .
• Docs Markdown reference

Resources for including code

• Technical principles checklist - Docs Contributor Guide

Code conventions

• Azure CLI
• Azure PowerShell
• C# Coding Conventions (C# Programming Guide)