Design

The grammar of good buttons

A button is a sentence. A short one, in the imperative. Here is how to write it well.

Samuel Okafor · · 4 min read
Interface work spread across a laptop, phone, and display.
Interface work spread across a laptop, phone, and display. Photo by Azwedo L.LC on Unsplash .

Good buttons do one thing and announce it clearly. Bad buttons hedge.

The quiet shape of an idea

There is a particular kind of pleasure in returning to a piece of writing after it has had time to settle. The sentences look at you differently. Some have grown weightier. Others, weightless, ask to be removed entirely.

Most of what I write begins as a small observation — a single image, an overheard phrase, a question that refuses to leave. I keep these in a plain text file and let them sit for as long as they need.

The best ideas are patient. They do not announce themselves; they accumulate.

Working in the open

Working in public is a deliberate constraint. It changes the kinds of decisions you make and the speed at which you make them. It is not, as is sometimes claimed, simply a marketing tactic.

A shorter feedback loop

The most useful effect is the shorter loop between intention and response. A piece published this morning may be read by a hundred people before lunch, and a thoughtful reply will arrive that reshapes the next draft.

  • Write first, edit later — but never publish without editing.
  • Trust the reader’s intelligence. Cut anything that explains too much.
  • Prefer the concrete to the abstract.

A note on tools

The tools matter less than people imagine, but they matter. A good editor disappears. A bad one inserts itself between you and the thought you were chasing.

// a small helper I keep returning to
const words = (text) => text.trim().split(/\s+/).filter(Boolean).length;

Closing

If there is a single thread running through these notes, it is this: do the work, do it slowly, and let it be plain. Readers will meet you the rest of the way.

Share
Written by
Samuel Okafor

Software engineer with a soft spot for typography and the open web.

Comments

Hook this up to your favourite commenting platform — Giscus, Disqus, or your own.

Continue reading

Design·

In praise of the narrow column

Why measure, that simple, ancient typographic constraint, is still the single most important decision on a reading page.

Samuel Okafor · 5 min

A quieter inbox.

One thoughtful letter every other Sunday — new essays, things worth reading, and the occasional photograph.

Free. Unsubscribe in one click.