voice-and-tone.md
markdown
sha256:87f84653ce4706be8c65b0c4494ed6fb891213cca82db2b1824772cddc41a752
feat(auth): durable MCP OAuth refresh via shared strong sto…
Agent
minor
63 days ago
title: "Style guide — voice and tone" project: "editorial-ops" tags:
- style-guide
- brand
- writing date: 2026-04-07
Voice and tone
Voice — Calm expert neighbor: competent, plainspoken, never sneering at beginners.
Tone — Warm by default; more direct in error messages and security notes.
Principles
- Lead with the user outcome, then the mechanism.
- Prefer short sentences; one idea per line in UI copy.
- Avoid hype adjectives (“revolutionary,” “game-changing”) unless tied to measurable proof.
Do / don’t
| Do | Don’t |
|---|---|
| “Your notes stay in a folder you control.” | “We leverage best-in-class synergies.” |
| “If sync fails, check your API token.” | “Oops! Something went wrong.” (without next step) |
| “Try this on a copy of your vault first.” | “Simply run the migration.” |
Words we like
- vault, index, export, plain Markdown
Words to use carefully
- AI — name the task (“summarize,” “extract tasks”) not the mystique.
- Local-first — define once per article for new readers.
Owner — editorial lead; review after major product positioning changes.
File History
5 commits
sha256:87f84653ce4706be8c65b0c4494ed6fb891213cca82db2b1824772cddc41a752
feat(auth): durable MCP OAuth refresh via shared strong sto…
Agent
minor
63 days ago
sha256:873e30b7fafe601346295f8f4289f388f21d8f715f28584d5481899ba2b714fc
Merge pull request #249 from aaronrene/muse-mirror
Agent
80 days ago
sha256:d8c648b20a4d53b2673c5c082ee7edfa7b2fc9b11080832da1f38807b6bf940b
fix(7C-L1b): route hosted delegation proposals through cani…
Human
minor
⚠
83 days ago
sha256:2827ba9e7632a4b141c50caf1e8f7d77abbc3515be20e7465f2bccb0ac4edf91
fix: repair endpoint now sets has_active_subscription when …
Human
minor
⚠
103 days ago
sha256:6a102aafafdfe7e70a24f4e59740200f0ee713ce7915f1b53e9d4ba5ee8b4410
Initial Muse snapshot
Human
135 days ago