Repository navigation
docs: state points plainly across the docs site - #627
Merged
Merged
Conversation
Drop restating closers, contrast phrasing that only adds weight, filler and sales words, and decorative bold, and close up slashes that mean or.
Drop inflated framing, restating closers, decorative bold, and version talk from the command pages, and close up slashes that mean or.
Drop staged openers and change narration, and close up slashes that mean or or turn them into lists. Security claims are unchanged.
…plainly Remove decorative bold from the rstix page, drop leftover drafting text and arrow chains, and fix a doubled word.
The lint rule bucket table has five rows and the input format test list has three items.
Merge fragment rows into sentences, lowercase all-caps emphasis, fix the LazyVim and AstroNvim names, and match the Helr transport count to its table.
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.
A prose-only editing pass over
docs/content, removing phrasing that adds weight without adding information: restating closers, contrasts against claims nobody made, inflated framing ("the lifecycle phase a mature detection program reviews on a cadence"), sales words ("leverages", "for free", "unlocking"), decorative bold, and all-caps emphasis. Slashes that mean "or" are closed up, or turned into a list when they join items.Code blocks, inline code, flags, config keys, metric names, link targets, headings (and so anchors), and docmd syntax are unchanged. Security wording keeps the same claims.
Three stated counts did not match the lists below them and are corrected: the lint rule buckets (five, not four), the input format test layers (three, not two), and the Helr fallback transports.
guide/enrichers.mdstill says "five primitives" in its intro and "four primitives" in the recipe and bespoke-enricher sections.stixis the feature-gated fifth primitive and is not a reserved name, so the four may be intentional there; it is left as is.npm run docs:buildandnpm run docs:validatepass.