Writing method

Every page starts from one plain question: what does a visitor need to understand here, and in what order? The text answers that question first, then adds the details that matter. Sentences stay short, and each paragraph makes a single point.

Writing happens in three passes. The first draft is written in full, without polishing. The second pass removes repetition, anything that overpromises, and anything that does not serve the starting question. The last pass is a read-aloud, which exposes sentences that run too long and transitions that stumble.

Headings say what the next section contains, with no wordplay. Lists are kept for items that are truly parallel. Jargon is avoided, or explained in the glossary when there is no plain alternative.