Skip to content
OpenPerf
Esc
↑↓navigate↵open⌘Jpreview
On this page

Writing

Short, plain English in sentence case. Name things the way people search for them.

  • Sentence case: “Last 30 days”, “Create issue”.
  • Counts are words, not badges: “2 selected”, “4 errors”.
  • Name filters as people say them: “Regressed”, not status=regressed.
  • Button labels are verbs: “Resolve”, “Archive”. Use one primary button per view.
  • A link goes somewhere, a button does something. Links inside text need no component: a plain <a> gets the accent colour from the theme.
  • Every user-visible string goes through Lingui; brand names, acronyms and code stay literal.
Do Don’t
No errors in the last 24 hours No data found
12 events 12 Events
Couldn’t load traces. Try again Error: request failed (500)

Was this page helpful?