docs(infrastructure): normalize structure and wording - #583
Open
mattaereal wants to merge 6 commits into
Open
Conversation
Add Key Takeaways, overview page map with DNS subsection, related frameworks, IAM pointer fix to /iam/overview, and contributor roles. Preserve DNS incident and control bodies.
Deploying frameworks with
|
| Latest commit: |
3c72c3f
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://3603445d.frameworks-573.pages.dev |
| Branch Preview URL: | https://docs-normalize-infrastructur.frameworks-573.pages.dev |
Match develop authorship exactly. Clear wrote/reviewed/fact-checked arrays where normalization invented authors on pages that had none. Do not attribute chrome-only edits as content authorship.
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 Infrastructure (
docs/pages/infrastructure/including domain-and-dns-security/).Why
Thin overview TOC; missing Key Takeaways; IAM page linked incorrectly to a mangled path (“Incident and Access Management”); DNS overview lacked child page map.
Substantive security changes
None beyond correcting the broken IAM internal link to
/iam/overviewand/iam/access-management.Validation
Dependencies
#561 by reference.
Reviewer focus