wip

docs/VOICE.md

@@ -1,197 +1,123 @@
-# GridPilot — Voice & Tone Guide  
-*A calm, clear, confident voice built for sim racers.*
+# GridPilot — Voice & Tone Guide
+
+*A calm, neutral, authoritative voice for motorsport infrastructure.*
 
 ---
 
 ## 1. Core Personality
 
-GridPilot’s voice is:
+GridPilot is:
+- calm
+- neutral
+- precise
+- experienced
+- understated
 
-### **Calm**  
-Never loud, never chaotic, never dramatic.
-
-### **Clear**  
-Short sentences. Direct meaning. Zero fluff.
-
-### **Competent**  
-We sound like people who know racing and know what matters.
-
-### **Friendly, not goofy**  
-Approachable and human — without memes, slang, or cringe.
-
-### **Non-corporate**  
-We avoid startup jargon and “enterprise” tone completely.
+We do not excite.
+We inform.
 
 ---
 
 ## 2. How GridPilot Sounds
 
-### **Direct**
-We make the point quickly. No fillers.
+### Clear
+Short sentences.
+No ambiguity.
 
-**Example:**  
-“Standings updated.”
+### Neutral
+No opinion.
+No hype.
+No exaggeration.
 
-### **Minimal**
-We remove unnecessary words.  
-Writing should feel clean — like the UI.
+### Competent
+We assume the user understands racing.
 
-### **Honest**
-We never overpromise or exaggerate.  
-GridPilot says what it does, nothing more.
-
-### **Human**
-Natural phrasing, like talking to another racer.
+### Professional
+We sound like race officials, not marketers.
 
 ---
 
 ## 3. What We Avoid
 
-### ❌ Corporate language  
-“scalable solution,” “empower,” “revolutionize,” “synergy”
+- marketing language
+- motivational phrasing
+- emotional exaggeration
+- jokes
+- slang
+- buzzwords
+- storytelling tone
 
-### ❌ Startup hype  
-“game-changing,” “disruptive,” “next-gen”
-
-### ❌ Gamer slang  
-“let’s gooo,” “pog,” “EZ clap,” emojis everywhere
-
-### ❌ Sales pressure  
-“Sign up now!!! Limited time only!!!”
-
-### ❌ Over-explaining  
-No long paragraphs to say something simple.
+GridPilot is not here to entertain.
+It is here to **operate**.
 
 ---
 
 ## 4. Tone by Context
 
-### **Landing Page**
-- calm  
-- confident  
-- benefit-focused  
-- no hype  
-- welcoming  
+### UI
+- direct
+- factual
+- tool-like
 
-Example:  
-“League racing should feel organized. GridPilot brings everything into one place.”
+Examples:
+- “Season created.”
+- “Driver approved.”
+- “Penalty applied.”
 
 ---
 
-### **In-App UI**
-- crisp  
-- tool-like  
-- neutral  
-- small sentences  
+### Errors
+- neutral
+- calm
+- no blame
 
-Examples:  
-“Race added.”  
-“Results imported.”  
-“Penalty applied.”
+Examples:
+- “Action failed.”
+- “Invalid input.”
+- “Try again.”
 
 ---
 
-### **Notifications**
-- non-intrusive  
-- soft  
-- clear  
+### Notifications
+- short
+- non-intrusive
 
-Examples:  
-“Your next race is tomorrow.”  
-“Standings updated.”
+Examples:
+- “Race starts in 30 minutes.”
+- “Results updated.”
 
 ---
 
-### **Errors**
-- helpful  
-- steady  
-- no blame  
+### Emails
+- factual
+- brief
+- no sales language
 
-Examples:  
-“Something went wrong. Try again.”  
-“Connection lost. Reconnecting…”
+Example:
+“Your season schedule has been updated.”
 
 ---
 
-### **Emails**
-- friendly  
-- simple  
-- short  
+## 5. Writing Rules
 
-Example:  
-“Your season starts next week. Here’s the schedule.”
+- remove unnecessary adjectives
+- use active voice
+- one idea per sentence
+- no filler
+- no persuasion
 
 ---
 
-## 5. Writing Style Rules
+## 6. Phrases We Prefer
 
-### **Short sentences**
-Easy to read. Easy to scan.
-
-### **Simple verbs**
-Join, manage, view, race, update.
-
-### **Active voice**
-“GridPilot updates your standings.”  
-Not:  
-“Your standings are being updated…”
-
-### **No marketing padding**
-We never pretend to be bigger than we are.
-
-### **Every sentence should have purpose**
-No filler words. No decorative language.
+- “All data in one place.”
+- “Clear standings.”
+- “Structured seasons.”
+- “Consistent rules.”
+- “No spreadsheets.”
 
 ---
 
-## 6. Phrases We Like
+## 7. One-line Voice Summary
 
-- “Everything in one place.”  
-- “Your racing identity.”  
-- “Clean standings.”  
-- “No spreadsheets.”  
-- “Race. We handle the rest.”  
-- “Built for league racing.”  
-- “Clear. Simple. Consistent.”
-
-These reinforce clarity and confidence.
-
----
-
-## 7. Phrases We Never Use
-
-- “premium experience”  
-- “unlock your potential”  
-- “cutting-edge AI”  
-- “transform the sim racing landscape”  
-- “we’re disrupting the industry”  
-- “epic,” “insane,” “crazy good,” etc.
-
-Anything salesy, dramatic, childish, or corporate is banned.
-
----
-
-## 8. Emotional Goals
-
-GridPilot should make people feel:
-
-### **In control**  
-Information is clear and predictable.
-
-### **Supported**  
-Admin work is easier. Driver info is organized.
-
-### **Respected**  
-We never talk down to users.
-
-### **Focused**  
-The tone keeps attention on racing, not us.
-
-### **Confident**  
-The platform feels stable and trustworthy.
-
----
-
-## 9. One-line Voice Summary
-
-**GridPilot speaks like a calm, competent racer who explains things clearly — never loud, never corporate, never cringe.**
+**GridPilot speaks like race control: calm, precise, and trustworthy.**