Skip to content

feat: Add Microsoft Learn Contributor chatmode for documentation guid…#95

Merged
aaronpowell merged 1 commit into
github:mainfrom
lukemurraynz:main
Jul 13, 2025
Merged

feat: Add Microsoft Learn Contributor chatmode for documentation guid…#95
aaronpowell merged 1 commit into
github:mainfrom
lukemurraynz:main

Conversation

@lukemurraynz

Copy link
Copy Markdown
Contributor

Add Microsoft Learn Contributor Chat Mode

This pull request introduces a new chat mode for GitHub Copilot Chat, specifically designed for contributing to Microsoft Learn documentation. The changes include updates to the README.md file to list this new mode and the creation of a detailed configuration file outlining its principles, behaviors, and technical specializations.

Additions to Chat Modes:

  • README.md: Added the "Microsoft Learn Contributor" chat mode to the list of available modes, including installation links for both VS Code and VS Code Insiders.

New Chat Mode Definition:

  • chatmodes/microsoft_learn_contributor.chatmode.md: Introduced a comprehensive configuration for the "Microsoft Learn Contributor" chat mode. This includes:
    • Persona overview, principles, and mission.
    • Detailed guidelines for writing, reviewing, and contributing to Microsoft Learn documentation.
    • Emphasis on compliance with the Microsoft Writing Style Guide, accessibility standards, and GitHub workflows.
    • Example prompts and responses to assist contributors in common scenarios.

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, or chat mode file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, or chat mode with GitHub Copilot.
  • I have run node update-readme.js and verified that README.md is up to date.

Description

This contribution adds a specialized chat mode for GitHub Copilot Chat that assists users in contributing to Microsoft Learn documentation. The mode provides expert guidance on Microsoft's writing style, documentation standards, accessibility requirements, and contribution workflows. It helps both new and experienced contributors create high-quality technical content that aligns with Microsoft Learn's editorial standards and guidelines.

The chat mode includes specialized knowledge about:

  • Microsoft Writing Style Guide compliance
  • Accessibility and inclusive design principles
  • GitHub workflow for documentation contributions
  • Technical writing best practices for learning content
  • Common scenarios and troubleshooting for contributors

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New chat mode file.
  • Other (please specify):

Additional Notes

This chat mode is designed to complement the existing Microsoft Learn contributor documentation and provide real-time assistance during the writing and review process. It has been tested with various common contributor scenarios and provides contextually appropriate guidance for different types of Microsoft Learn content including tutorials, quickstarts, and reference documentation.


By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Copilot AI review requested due to automatic review settings July 13, 2025 22:25

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR introduces a new “Microsoft Learn Contributor” chat mode designed to guide authors through contributing to Microsoft Learn documentation, and updates the README to list the new mode.

  • Adds a detailed chatmode file defining persona, principles, behaviors, and technical guidance
  • Updates README.md to include the new chat mode in the available modes list

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
chatmodes/microsoft_learn_contributor.chatmode.md New chat mode definition covering persona, principles, and tool usage
README.md Added “Microsoft Learn Contributor” entry to the chat modes table
Comments suppressed due to low confidence (1)

chatmodes/microsoft_learn_contributor.chatmode.md:373

  • The websearch tool is mentioned here but not included in the front matter tools list; consider adding it to the tools array or updating the instruction to use an existing tool.
- Use `websearch` to find the latest Microsoft branding and product information

@aaronpowell aaronpowell merged commit 5d42f20 into github:main Jul 13, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants