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.
This is an example article for the development preview. It shows how a longer piece of writing, an image and a few different kinds of content sit together on the page.
Start with something specific
A useful technical note 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 diagram 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.