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.
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:
- Describe the question in plain language.
- Show enough of the experiment for someone else to follow it.
- 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