Skip to content

Add docs style guide#66

Merged
archie-mckenzie merged 9 commits intomainfrom
style-guide-v3
Mar 2, 2026
Merged

Add docs style guide#66
archie-mckenzie merged 9 commits intomainfrom
style-guide-v3

Conversation

@moss-bryophyta
Copy link
Copy Markdown
Collaborator

Comprehensive style guide based on patterns from all my docs PRs. Covers naming conventions, grammar, formatting, code examples, and structural guidelines.

Draft for team review and refinement.

(Replaces #63, rebased on current main.)

@archie-mckenzie archie-mckenzie marked this pull request as ready for review March 2, 2026 04:27
@archie-mckenzie archie-mckenzie requested a review from a team as a code owner March 2, 2026 04:27
- Sentence case headings, numbered step format
- List punctuation rules (fragments vs full sentences)
- Oxford comma, em dash avoidance, i.e./e.g. conventions
- Callout bold-lead pattern
- API ref and guide page structure templates
- Common component patterns (tabs, accordions, ✅/❌, TypeTable)
- Template placeholder reference
- Custom heading anchors

Co-authored-by: moss-bryophyta <261561981+moss-bryophyta@users.noreply.github.com>
@archie-mckenzie archie-mckenzie merged commit 7056a61 into main Mar 2, 2026
3 checks passed
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