Method

How we verify

Every page carries a line saying when it was checked and whether we reproduced it. This page explains what those words mean.

What "checked" means

The checked date is the day we last ran the thing on this page and compared the output to what the text says. It is not the publication date, and it is not generated automatically. If a page has not been re-run recently, the date stays old — that is the point of it.

What "reproduced" means

ValueMeaning
yesWe ran it end to end and the output is shown as we saw it, trimmed for length only.
partialWe ran part of it. The page says which part we did not run and why.
noWe have not run it. The section is written from documentation and labelled as such.

Where the numbers come from

  • Money is read from our own provider billing pages and terminal output, not from a price list.
  • Versions are pinned on each page. A page written against one release is not quietly updated for the next.
  • Timings are from a single machine unless the page says otherwise.

What we will not do

  • Publish a figure we did not measure, dressed as if we had.
  • Move a date without changing the sentence beside it.
  • Rewrite a vendor's documentation in the first person and call it a test.

How a command is presented

Commands are shown with the check you should run next to them, not just the command. Copy the block, run the check, compare. This is the exact pair used to build this site:

$ npm run build; echo $?
0

Corrections

Send the page, the figure and your result to hello@agenthardway.com. Substantive changes are logged on the changes page.