Leave a connection check easy to repeat
A short record of the question, conditions and result is usually more reusable than a large collection of unexplained output.
The complete index
Notes
Notes for making a small investigation understandable to the next reader.
Begin with any of these seven notes. The section list and neighbouring readings offer a route back when a question changes.
Finish a small piece of work
An action finishing is useful evidence. The result that another person will use deserves its own check and a short route back.
Read a reference note with a question in hand
A reference page is easier to use when you know which decision it should help you make. Reading can be a small, directed part of the work.
Read a failure one layer at a time
A connection can fail before a name is resolved, during a secure handshake or after a request arrives. Naming the layer narrows the next check.
Revise a note without losing its context
A living note should become clearer as evidence changes. Preserve the reason for a decision without keeping every intermediate draft in the reader's path.
Give a small page a small request budget
The work of opening a page includes its supporting files. A useful page can remain rich in explanation while asking the network to do very little.
Keep names and addresses separate
A name is a durable label. An address is one answer about where to try a connection. Treating them as separate observations makes a problem easier to describe.