Skip to content

docs(skills): refresh ADR standards references - #2761

Merged
Bill Berry (WilliamBerryiii) merged 4 commits into
microsoft:mainfrom
tomomi-code:docs/2585-refresh-adr-standards
Aug 29, 2026
Merged

docs(skills): refresh ADR standards references#2761
Bill Berry (WilliamBerryiii) merged 4 commits into
microsoft:mainfrom
tomomi-code:docs/2585-refresh-adr-standards

Conversation

@tomomi-code

Copy link
Copy Markdown
Contributor

Description

Refreshed the ADR standards reference after reviewing its current contracts and upstream sources:

  • Aligned MADR and Y-Statement descriptions with the current output-template contract.
  • Added canonical source links, clarified citation-only handling, and updated the review date.

Related Issue(s)

Fixes #2585

Type of Change

  • Documentation update

Sample Prompts (for AI Artifact Contributions)

Not applicable. This change updates supporting reference documentation only.

Testing

  • Passed npm run validate:docs, npm run spell-check, frontmatter validation, and skill validation.
  • Passed targeted link validation for the changed file.

Checklist

Required Checks

  • Documentation is updated (if applicable)
  • Files follow existing naming conventions
  • Changes are backwards compatible (if applicable)
  • Tests added for new functionality (N/A: no functionality changed)

Required Local Checks

The following local-safe validation commands must pass before merging:

  • Local validation aggregate: npm run validate:local
  • Documentation validation (if docs changed): npm run validate:docs
  • Spell checking: npm run spell-check
  • Link validation: npm run lint:md-links

Security Considerations

  • This PR does not contain any sensitive or NDA information

Additional Notes

npm run validate:local and the full link check are blocked by an unrelated link failure in .github/skills/project-planning/security-planning/references/data-classification.md.

@codecov-commenter

Codecov Comments Bot (codecov-commenter) commented Aug 24, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.06%. Comparing base (68308dd) to head (52d34ab).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #2761      +/-   ##
==========================================
- Coverage   83.08%   83.06%   -0.03%     
==========================================
  Files         183      169      -14     
  Lines       33712    32880     -832     
  Branches       25        0      -25     
==========================================
- Hits        28010    27312     -698     
+ Misses       5699     5568     -131     
+ Partials        3        0       -3     
Flag Coverage Δ
docusaurus ?
pester 83.87% <ø> (+0.05%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 24 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@WilliamBerryiii
Bill Berry (WilliamBerryiii) merged commit c732fc1 into microsoft:main Aug 29, 2026
118 checks passed
@github-actions github-actions Bot mentioned this pull request Aug 29, 2026
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.

docs: Update stale documentation - .github/skills/project-planning/adr-author/references/standards-excerpts.md

4 participants