docs: clarity polish (SafeMode framing, CriticMarkup scope, cross-refs) - #194
Merged
Conversation
…s, page cross-refs) - security.md: reframe "Relationship to the spec's SafeMode" heading -> "Beyond the baseline: SafeMode and Profiles"; clarify the page baseline is the normative default and SafeMode/Profile are optional implementation-level policy layered on top. - dismissed-syntax.md: scope the CriticMarkup entry to the dismissed doubled-marker form; note the feature itself was adopted (single markers, section 4.14), so it is no longer mistaken for a wholesale dismissal. - index.md: gloss the first "Djot" mention on the home page; drop em dash. - comparison.md / markup-languages.md: cross-link the two and state each page's scope (Carve-centric vs broad neutral survey).
dereuromark
added a commit
that referenced
this pull request
Jun 27, 2026
…s, page cross-refs) (#194) - security.md: reframe "Relationship to the spec's SafeMode" heading -> "Beyond the baseline: SafeMode and Profiles"; clarify the page baseline is the normative default and SafeMode/Profile are optional implementation-level policy layered on top. - dismissed-syntax.md: scope the CriticMarkup entry to the dismissed doubled-marker form; note the feature itself was adopted (single markers, section 4.14), so it is no longer mistaken for a wholesale dismissal. - index.md: gloss the first "Djot" mention on the home page; drop em dash. - comparison.md / markup-languages.md: cross-link the two and state each page's scope (Carve-centric vs broad neutral survey).
4 tasks
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.
Low-priority clarity items from the full-docs re-audit (follow-up to #191/#192/#193).
Relationship to the spec's SafeModeread as if SafeMode were normative. Reframed toBeyond the baseline: SafeMode and Profiles; the page baseline is the normative default, SafeMode/Profile are optional implementation-level policy layered on top.Djotmention on the home page (it was used before being introduced); dropped an em dash.Docs build passes.