<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
Using inclusive language isn’t just about words; it’s about creating a space where everyone feels respected and valued. By being thoughtful with our language, we can avoid reinforcing stereotypes and biases and promote equality for all. Here’s how to keep it inclusive: