Skip to content

docs: drop dashes and bold labels from the site, profile and repo docs - #131

Merged
lesnik512 merged 1 commit into
mainfrom
docs/humanize
Oct 17, 2026
Merged

lesnik512 merged 1 commit into
mainfrom
docs/humanize

Conversation

@lesnik512

Copy link
Copy Markdown
Member

A prose pass to remove AI-writing tells from docs/index.md, profile/README.md, README.md, CONTRIBUTING.md, brand/README.md, CONTEXT.md and AGENTS.md. No facts, repo names, links, tables or code changed.

  • Mid-sentence em dashes are now colons, commas, semicolons or separate sentences. The hero line is edited the same way on the site and the profile, so the two still match.
  • Bold-label bullets are plain: "The stack" on the site, "Ways to contribute", and the README.md list, which is now a short paragraph. The profile's "Which one?" label is gone; the sentence after it already says which one.
  • CONTEXT.md: the _Avoid_: lines use a period or parentheses in place of the dash. Glossary terms stay bold.
  • Emphasis bold inside sentences is removed in brand/README.md, CONTEXT.md and AGENTS.md.

Deliberately unchanged: docs/DEPLOYMENT.md (arrows), the bold card titles in the site's grid (Material card markup), the **cream** table cell in brand/README.md, the "~70–80%" range, and files outside this pass (docs/standard.md, SUPPORT.md, SECURITY.md, CODE_OF_CONDUCT.md, the ADRs).

uv run pytest passes (175 tests, including the profile/site listing invariants) and mkdocs build --strict is clean.

@lesnik512
lesnik512 merged commit 99a0153 into main Oct 17, 2026
3 checks passed
@lesnik512
lesnik512 deleted the docs/humanize branch October 17, 2026 18:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant