docs: fix schema errors, invalid commands, and mark apm audit as roadmap#250
Closed
docs: fix schema errors, invalid commands, and mark apm audit as roadmap#250
Conversation
- Fix apm.yaml → apm.yml in security.md (4 occurrences) - Fix packages: → dependencies: apm: schema in teams.md and governance.md - Replace apm add with apm install in adoption-playbook.md - Mark apm audit/apm audit --ci/--drift as roadmap across governance.md, adoption-playbook.md, making-the-case.md, github-rulesets.md, ci-cd.md, and lockfile-spec.md - Use github: shorthand source URLs in governance.md example Co-authored-by: danielmeppiel <51440732+danielmeppiel@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Migrate documentation to Astro Starlight site
docs: fix schema errors, invalid commands, and mark apm audit as roadmap
Mar 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Several doc pages contained incorrect manifest schema keys, non-existent CLI commands, wrong filename references, and claimed
apm auditwas "Available now" when it doesn't exist yet.Changes
Schema corrections
packages:→dependencies: apm:inteams.md(2 examples) andgovernance.md(1 example)github:org/reposhorthand ingovernance.mdexample (was using full HTTPS URLs)Filename fix
apm.yaml→apm.ymlinsecurity.md(4 occurrences)Invalid command fix
apm add org/pkg→apm install github:org/pkginadoption-playbook.md(apm adddoes not exist;apm installaccepts package arguments)apm auditmarked as roadmap/WIP across 6 filesapm audit --ci,apm audit --driftdon't exist. All references now include a> **Roadmap:**callout. Specific changes:governance.md: pipeline diagram, CI enforcement section, drift detection section, required status check level (was "Available now" → "Planned"), change management stepadoption-playbook.md: Phase 3 CI step commented out with note, Phase 5 success metricmaking-the-case.md:apm install --check→apm audit --ci(roadmap) in talking points, comparison table, and next stepsgithub-rulesets.md: page intro, governance levels tableci-cd.md: governance section headerlockfile-spec.md: CI pipelines referenceType of change
Testing
📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.