Tip #25

Clarity beats cleverness

Takeaways

  • Naming conventions aren’t poetry slams.
  • Use consistent, descriptive labels
  • Avoid “internal jokes” in naming
  • Think onboarding, not insiders

🔖 A system is only as clear as its language.

Quick action:

Rename one misleading or confusing token — and explain the change publicly.