docs(incident-management): normalize structure and wording - #586
Open
mattaereal wants to merge 6 commits into
Open
docs(incident-management): normalize structure and wording#586mattaereal wants to merge 6 commits into
mattaereal wants to merge 6 commits into
Conversation
Add canonical Key Takeaways, contributor fact-checked roles, nested page maps, absolute internal links where chrome was touched, and ContributeFooter separators. Preserve procedure and checklist bodies.
Deploying frameworks with
|
| Latest commit: |
45b8255
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://f1a60db9.frameworks-573.pages.dev |
| Branch Preview URL: | https://docs-normalize-incident-mana.frameworks-573.pages.dev |
Rewrite non-stub frontmatter descriptions into the acceptable length band (preferred 140–160). Stub pages exempt. No body or credit changes.
Rename Further Reading H2s to the exact title the updated #561 validator accepts; sentence-case a few common section headings.
Child pages missing a canonical further/related H2 failed the updated #561 validator. Add a minimal Further Reading block linking the framework overview.
Neutralize fence comments that look like headings, canonicalize overview page-map titles, clamp descriptions, demote excess H2s, and mark template pages with content-model exceptions.
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
1 participant
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.
Scope
Normalize content chrome for
docs/pages/incident-management/**only (SEAL frameworks content model). No other frameworks.Why
Align Incident Management pages with canonical Key Takeaway format, contributor roles, nested overview page maps, footer separators, and absolute internal links—matching prior framework normalize PRs.
Content model applied
> 🔑 **Key Takeaway**:(colon outside bold) from existing page substancecontributorswithwrote/reviewed/fact-checked(preserve usernames; empty arrays OK)##---before<ContributeFooter />index.mdxChanges
Substantive security guidance changes
None. Procedures, checklists, runbook steps, and template bodies preserved.
Intentionally unchanged
index.mdxfiles.mailmapValidation
Dependencies
Depends on content-model direction from #561 by reference only (no hard merge block intended beyond develop base).
Reviewer focus
vocs.config.tssidebar children