Preview · Example posts

A useful question is a good place to start

A layout example for a longer note, with an illustration and room to follow a thought.

Most of the notes I end up keeping started as one small question I could not answer at the time. This is a layout example, but the shape is the point: question first, then what I tried, then what happened.

Placeholder for a photograph
A photograph would sit here.

Start with something specific

A piece of writing can begin with a small question. What were you trying to do? What did you expect? What actually happened?

The detail gives a reader something they can recognise and try for themselves. It also leaves space for an honest answer when something remains unresolved.

A note does not have to settle the whole subject. It can make one part of it a little clearer.

Leave room for the evidence

An article can include a short list when the sequence matters:

  1. Describe the question in plain language.
  2. Show enough of the experiment for someone else to follow it.
  3. Explain the result, including what you still do not know.

Code can live alongside the explanation, without requiring a screenshot:

const question = "What changed?";
const notes = { question, observation: "Write what you actually saw." };

Stop when the point is made

Some posts will be a few paragraphs. Others may need examples, a photo or a longer explanation. The same quiet layout can make room for both.

These words are demonstration copy. The published notebook will contain the author’s own experiences and opinions.

Also: Keeping a note for the next person · There is room for small experiments