Hello, Field Notes
· 1 min read
What this site is, how it is built, and what to expect here.
Field Notes
Short notes on building software, published as a static site from markdown files.
Writing the first draft fast
· 1 min read
Why the first draft should be written in one sitting, and how to make that possible.
A note on naming things
· 1 min read
Names are the cheapest documentation you will ever write.
Keeping a changelog by hand
· 1 min read
Generated changelogs list commits; a written one tells the reader what changed for them.
The case for static sites
· 1 min read
A site that is only files has nothing to break at three in the morning.
Markdown is enough
· 1 min read
Plain text with a little structure outlives every editor that tried to replace it.
Reading logs before guessing
· 1 min read
One observed value beats thirty minutes of plausible theories.
Small commits
· 1 min read
The commit is the undo button; keep it within reach.
Feeds still work
· 1 min read
RSS and Atom are the quietest, most durable way to publish.
Tests for the next person
· 1 min read
A test is a sentence about behaviour that a machine keeps true.