Skip to content

docs: Add voice and tone guide for marketing copy - #433

Draft
ericholscher wants to merge 2 commits into
mainfrom
claude/voice-tone-guide-fypg0e
Draft

docs: Add voice and tone guide for marketing copy#433
ericholscher wants to merge 2 commits into
mainfrom
claude/voice-tone-guide-fypg0e

Conversation

@ericholscher

Copy link
Copy Markdown
Member

Add a comprehensive voice and tone guide for Read the Docs marketing copy, including blog posts, site pages, newsletters, announcements, and CTAs.

This guide documents our existing house style and makes it repeatable across all marketing and public-facing communication. It covers:

  • Brand personality: Five adjectives that define our voice (Direct, Credible, Honest, Grounded, Warm)
  • Core voice principles: Eight foundational principles including leading with benefits, proving claims with specifics, and being honest about hard things
  • Tone by context: A reference table for adjusting tone across different situations (homepage, announcements, deprecations, incidents, etc.)
  • Language patterns: Specific words and phrases we use and avoid, plus grammar and mechanics guidelines
  • Quick checklist: Pre-publishing verification steps to ensure consistency

The guide emphasizes our differentiators as a bootstrapped, open source company: transparency, respect for both commercial and open source audiences, and substance-driven communication without hype.


Generated by AI

https://claude.ai/code/session_01VBMdiFnopLRWSTmt2qhPj7

@davidfischer

Copy link
Copy Markdown
Contributor

This looks great!

- Remove misattributed testimonial quote and overstated emoji claim
- Add before/after examples and usage workflows
- Reference the guide from AGENTS.md so AI-drafted copy follows it
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.

3 participants