docs: strip em/en dashes and tighten AI-tell prose#32
Merged
Conversation
User flag: docs were leaning AI-generated, which is a turn-off for
operators in 2026. Pass through every chapter to:
* Remove every em-dash (U+2014) and en-dash (U+2013). Bullet-list
definitions go from "name() -- desc" to "name(). desc."
Sentence asides go from "X -- Y" to either "X. Y." or "X (Y)".
* Cut hedging adjectives (comprehensive, robust, seamless, etc.).
* Drop section transitions ("Now let's look at...", "Here's...").
* Replace triplet bullet rhythms with prose where the list
pattern was filler.
* Match the README's voice: terse, opinionated, period-heavy.
No content changes. Same chapters, same examples, same migration
notes. Just voice and punctuation.
albedosehen
added a commit
that referenced
this pull request
May 9, 2026
The docs workflow had been silently failing at the actions/configure-pages@v5 step on every push to main since PR #31 introduced it (PRs #31, #32, #34 all red on this leg) because Pages was never enabled at the repo level. The site at oneiriq.github.io/rota/ was returning HTTP 404 the whole time despite the docs PRs claiming it was shipping. Manually POSTed to /repos/Oneiriq/rota/pages with build_type=workflow to unblock the current state, and run 25601961989 confirms the workflow now builds and deploys end-to-end (oneiriq.github.io/rota/ returns 200 with the mdBook content). Adding enablement: true here as the durable fix so a future fork or a repo where Pages gets disabled doesn't silently regress to the same hidden 404 state.
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.
Voice pass over the docs site shipped in #31.
User flag: chapters were leaning AI-generated. Operators in 2026 read past that quickly.
Changes:
name(). desc.) instead of a dash separator. Sentence asides go to periods or parens.No content changes. Same chapters, same examples, same migration notes.
Test plan
grep -rn '[—–]' book/src/ README.mdreturns no matches