↑↓ move↵ open[] previous / next lesson? all shortcuts
Appearance
Theme
Type size
Reading

Focus mode hides the sidebars. Press f to toggle it anywhere.

Keyboard shortcuts
/
Search
[ ]
Previous / next lesson
t
Jump to the table of contents
r
Review queue
f
Focus mode
?
This panel
Skill8 min

The notebook, and the build log

How to write things down so that a plot from March still means something in November, and how a notebook entry becomes a build log on this site.

On this page8 min
  1. What goes in
  2. Paper or digital
  3. From notebook to build log
  4. Two rules for plots
  5. A minimum viable entry

The notebook is the one habit on this site that I would keep if I had to drop everything else. Not because anyone will grade it. Because in six weeks you will not remember which resistor you used, and in six months you will not remember why the dropped between Tuesday and Thursday, and the plot you saved will have no axes on it.

What goes in

Figure 1. One session, in three parts. The prediction in the first box is the line that does the work; everything else is bookkeeping that turns out to matter in November.

Every session, before you touch anything: the date, what you intend to do, and what you expect to see. That last line is the important one. Writing down the prediction is what turns fiddling into an experiment.

During the session: what you actually did, with part numbers and values. “ resistor 500 Ω, so ≈ 100.” “ at O1 and left earlobe, Ten20, on forehead.” The exact command you ran. A sketch of the wiring, photographed and taped in if it was on paper.

After: what you saw, with numbers and units. “60 Hz peak about 2 V pp at the output before the , about 200 mV after.” What went wrong. What you will do next time. A plot, with labelled axes and a title, saved to a folder named by date.

Paper or digital

Either, as long as it is one place. Paper is faster at the bench and impossible to lose to a corrupted drive. A plain-text file or a notes app is searchable. I use paper at the bench and copy the essential lines into a text file at the end of the day. Photograph the paper pages; a phone photo of a page of wiring notes has saved me more than once.

Whatever you choose, never use a tool that requires a subscription to read your own notes later.

From notebook to build log

A build log is a notebook entry cleaned up for another person. It has a fixed shape on this site, and the shape is the point: what I set out to do, what I actually did, what went wrong, what I measured, what I would change, what surprised me. There is a template and an example.

The build logs are the portfolio. A resume says “built an amplifier.” A build log shows the plot, the noise number, the mistake, and the judgment that came out of it. Recruiters and professors read the second kind of thing, and almost no student produces it.

Two rules for plots

Every plot has axes with units and a title that says what it is and when it was taken. Every plot that matters gets the raw data saved next to it, as CSV, so it can be re-plotted. “Look at this trace I saved as a screenshot” is a sentence that ends careers in labs.

A minimum viable entry

If you are tired and want to skip it, write four lines:

2026-09-14  single-channel EEG, breadboard v2
did: moved DRL from forehead to right earlobe
saw: blink artifact dropped from ~200 µV to ~120 µV; alpha unchanged
next: solder it

That is enough. Four lines a session for four years is a record almost nobody has.

Recall
What is the one line in a notebook entry that turns fiddling into an experiment?
The prediction, written down before you start: what you expect to see.
Recall
What two things does every plot need before it is saved?
Labelled axes with units and a title (what, when), plus the raw data saved beside it as CSV.