prose: the whole site to the house writing style - #116
Merged
Merged
Conversation
… all tebako prose
… spec index to the house style
…les to the house style
…ust, comparisons to the house style
…riants bench, packed-mn
…tch, driver-contract, encryption to the house style
…ion, jails-and-proxying, migrate-v1-v2 to the house style
…, runtime-as-image, store, vfs to the house style
…ng renderer takes plain text)
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.
What
The site's entire published prose is rewritten to the house writing style (
branding/WRITING-STYLE.md, adopted from oimlsmart/branding — the announcement register for posts, the technical register for documentation and pages). 75 files:_docs/guides(14) +_docs/reference(10)_docs/architecture(25)_posts/2026-*(23 — the posts since 2026; pre-2026 posts untouched)src/pages(index, about, 404)What changed
Fragments, headline clips, teaser lines, second-person descriptive prose, contractions, marketing asides and coined-label leads became complete declarative sentences with stated agents; announcements moved to the present perfect and explanations to the present tense; terms are expanded at first use; boundaries are stated as sentences. Headline labels, section headings, anchors and all structure are preserved.
What did NOT change
Every
----code block,++++passthrough (SVG figures),//comment, command, output, path, version, benchmark number, link, xref and anchor is byte-identical to main — verified per-file by fence-region extractors in each pass, plus the site's ownprose-lint.test.tsand frontmatter zod schemas.npm run buildexits 0 (the full page set builds).Content bugs found and deliberately NOT fixed here (style-only PR — each needs a facts decision)
shims.adocsays there is notebako doctor;debug.adoc+cli-tebako.adocdocument it as shipped in v2.8.0 — one page is stale.library.adoccites atebako shim useverb that no reference lists.repositories.adoc(detached signatures live since v2.6.0) contradictschain-of-trust.adoc(detached.ascsignatures listed as planned).about.astrostill describes the Ruby runtime as "patched and embedded" — the v1 model; the v2 architecture is a downloaded, shared, mounted runtime.migrate-v1-v2.adocsays prebuilt binaries are "still in final validation", predating the first tagged releases.