Skip to content

Standardize title capitalization to sentence case#117

Merged
beran-t merged 4 commits intomainfrom
fix-title-capitalization
Feb 19, 2026
Merged

Standardize title capitalization to sentence case#117
beran-t merged 4 commits intomainfrom
fix-title-capitalization

Conversation

@beran-t
Copy link
Copy Markdown
Contributor

@beran-t beran-t commented Feb 18, 2026

Summary

Standardizes all documentation titles, headings, and component titles to sentence case — only the first word and proper nouns/acronyms are capitalized.

Why sentence case?

  • Consistency — the docs were ~65% sentence case already, with Title Case scattered mostly in the template section and agent pages. This aligns everything to the dominant convention.
  • Easier to maintain — sentence case has one simple rule (capitalize first word + proper nouns). Title Case requires judgment calls on words like "with", "is", "and" — different style guides disagree, and inconsistencies like "User And Workdir" were already creeping in.
  • Industry standard for dev docs — Stripe, Vercel, Next.js, Supabase, Tailwind, and most modern developer documentation use sentence case.

Converts all Title Case headings, page titles, sidebar titles, and
navigation group names to sentence case — only the first word and
proper nouns/acronyms remain capitalized.
Extends the capitalization fix to component title attributes
(Card, Accordion, Tab, Step, Note) that render as visible section
headings on the page.
beran-t

This comment was marked as outdated.

beran-t

This comment was marked as outdated.

@beran-t
Copy link
Copy Markdown
Contributor Author

beran-t commented Feb 18, 2026

Re: BYOC — agree to keep "BYOC (Bring Your Own Cloud)" capitalized. It's the proper name behind the acronym, and the body text already uses the capitalized form. Recommend reverting the title and sidebarTitle changes in docs/byoc.mdx back to the original casing.

- Fix missed headings in cli/auth.mdx, ci-cd.mdx
- Fix missed titles in nextjs.mdx, nextjs-bun.mdx
- Revert BYOC title/sidebarTitle to capitalized form (proper name)
- Fix stale link text "User And Workdir" in how-it-works.mdx
Copy link
Copy Markdown
Contributor

@matthewlouisbrockman matthewlouisbrockman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

styling change, seems fine. possibly worth adding linter if care about this moving forward (would probably just stick a package.json in root and add linter there)

@beran-t beran-t merged commit d3d3d64 into main Feb 19, 2026
6 checks passed
@beran-t beran-t deleted the fix-title-capitalization branch February 19, 2026 19:54
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.

2 participants