Reading Room

A collection of brief reading notes.

Reading technical documentation

Begin with the overview, then find a complete example. Check the version attached to each reference and keep a note of assumptions. Return to the specification when an example leaves an important behavior unclear.

Notes that age well

A useful note carries enough context to be understood later. Include the problem, the decision, and the reason. Prefer a short explanation with a dated reference over a list of unexplained commands.

Working through a difficult book

Read in small sessions and write a few questions after each section. Revisiting those questions helps connect the material. A summary in your own words is a practical check of understanding.