docs: cut the AI cadence from every page - #5
Open
ibreakthecloud wants to merge 1 commit into
Open
ibreakthecloud wants to merge 1 commit into
ibreakthecloud wants to merge 1 commit into
Conversation
The content was specific and mostly right. The voice was not: 170 em-dashes
across 11,600 words, the same "X is not Y, it is Z" reframe on every page,
and a metronomic sentence rhythm that read as generated even where the
claims were hard-won and checkable.
Every em-dash is gone. Bullet definitions take a colon, appositives become
their own sentence, and the parenthetical asides that carried three clauses
are now two sentences of different lengths. Titles with a dash in them use a
colon, which also fixes them for search results.
Beyond the mechanical pass, the recurring structures went too: negation
setups, adverbs doing hedging work ("genuinely", "simply", "actually"),
false agency where a mechanism was the subject of a human verb, and the
narrator voice that described the system from a distance rather than telling
the reader what they get. Where a sentence explained what something is not
before saying what it is, it now says what it is.
Two facts were corrected while I was in here. Pro runs BYOC today, since the
managed-dedicated fleet is written but not deployed, and the introduction
now links session mode from the "where to go next" list rather than leaving
the new page unreachable from the landing page.
Docusaurus builds clean.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UN9aNw4GUxve22k988rNdD
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
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.
The content was specific and mostly right. The voice was not.
170 em-dashes across 11,600 words, the same
X is not Y, it is Zreframe on nearly every page, and a metronomic sentence rhythm that reads as generated even where the claims are hard-won and checkable. Uniform cadence is a stronger tell than any single sentence, and it was uniform across all 13 pages.What changed
Every em-dash is gone. Bullet definitions take a colon. Appositives become their own sentence. The parenthetical asides carrying three clauses are now two sentences of different lengths. Page titles with a dash use a colon, which also reads better as a search result.
The recurring structures went with them: negation setups, hedging adverbs (
genuinely,simply,actually), false agency where a mechanism was the subject of a human verb, and the narrator-at-a-distance voice. Where a sentence explained what something is not before saying what it is, it now says what it is.Rhythm:
introduction.mdandsandbox.mdwere rewritten whole rather than patched, because their problem was pacing rather than individual sentences. Mean sentence length is now ~16 words with a standard deviation of 9-10, against the near-flat distribution before.Two facts corrected on the way through
tiers.mdimplied you could buy it.session-mode.mdexisted but nothing inintroduction.mdlinked to it.Verification
npm run build(Docusaurus) succeeds. I touched YAML frontmatter on several pages to fix dashed titles, so the build passing is the check that matters here.🤖 Generated with Claude Code
https://claude.ai/code/session_01UN9aNw4GUxve22k988rNdD