Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 13, 2026

Description

Addressed 6 review comments in PR #6130 improving accessibility, consistency, and clarity of Copilot development documentation.

Changes

Accessibility improvements

  • Replaced mathematical symbols (≤ 3) with plain English ("up to 3") in worktree usage recommendations
  • Ensures screen readers and non-technical audiences can parse guidelines correctly

Markdown formatting consistency

  • Standardized emphasis: replaced all-caps (ONLY, WHAT, WHEN, AS-IS, MODIFIES) with proper markdown bold formatting (**only**, **What**, **When**, "as-is", "modifies")
  • Aligns with GitHub documentation standards and improves visual scanning

Technical clarity

  • Clarified "Copilot-generated branches" → "branches created using GitHub Copilot assistance or by Copilot agents"
  • Updated PowerShell comment: "angle-bracket-hash-exclamation markers" → explicit "<#! and #> markers"

Files Modified

  • tools/git/Worktree-Guidelines.md - 3 accessibility fixes
  • .github/instructions/agent-skills.instructions.md - 3 markdown formatting fixes
  • .github/skills/worktree-manager/scripts/WorktreeLib.ps1 - 1 comment clarity fix

Validation

A microsoft employee must use /azp run to validate using the pipelines below.

WARNING:
Comments made by azure-pipelines bot maybe inaccurate.
Please see pipeline link to verify that the build is being ran.

For status checks on the main branch, please use TransportPackage-Foundation-PR
(https://microsoft.visualstudio.com/ProjectReunion/_build?definitionId=81063&_a=summary)
and run the build against your PR branch with the default parameters.

Original prompt

Review PR #6130 with MCP

User requests using MCP server to review PR #6130 Add comprehensive guidelines and tools for Copilot development.

Created from VS Code via the GitHub Pull Request extension.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI changed the title [WIP] Review PR #6130 on Copilot development guidelines Address accessibility and consistency issues in Copilot development guidelines Jan 13, 2026
Copilot AI requested a review from yeelam-gordon January 13, 2026 05:02
Base automatically changed from user/yeelam/CopilotInstructions to main January 13, 2026 11:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants