<aside> 🚨
Language creates reality. Filmhub’s language philosophy advocates for simplicity, clarity, and functionality. How might I reduce cognitive load for others? Inspired by axioms.
</aside>
If I had more time…I would have written less!
Start each list or paragraph with an eye-catching anchor, e.g. “Why it matters:”
Use bullet points—they’re your new best friend!
Keep prose short and sweet—3 lines max!
Guideline | ❌ Instead of… | ✅ do… |
---|---|---|
Avoid filler words | Make sure that the festivals use V2 format | Festivals use V2 format |
Be concise | Set up a DataDog alert if items are waiting in queue for longer than 2 days | Create DataDog alert for queued deliveries >2 days old |
Be precise | • Handle Delivery Worker 404 error | |
• Submit button is not working | • Retry delivery message on S3 404 status | |
• Submit button disabled when form is dirty | ||
Remove filler phrases | • |
|
• |
• ”Max batch queue size is 1000” | |
• ”Update” |
Avoid filler words: phrases like these clutter the actual information