# Field Notes

> Short notes on building software, published as a static site from markdown files.

Every post is available as markdown at the same path with a `.md` extension; the full index is at http://localhost:3000/posts.json.

## Posts

- [Hello, Field Notes](http://localhost:3000/hello-field-notes.md): What this site is, how it is built, and what to expect here.
- [Writing the first draft fast](http://localhost:3000/writing-the-first-draft-fast.md): Why the first draft should be written in one sitting, and how to make that possible.
- [A note on naming things](http://localhost:3000/a-note-on-naming-things.md): Names are the cheapest documentation you will ever write.
- [Keeping a changelog by hand](http://localhost:3000/keeping-a-changelog-by-hand.md): Generated changelogs list commits; a written one tells the reader what changed for them.
- [The case for static sites](http://localhost:3000/the-case-for-static-sites.md): A site that is only files has nothing to break at three in the morning.
- [Markdown is enough](http://localhost:3000/markdown-is-enough.md): Plain text with a little structure outlives every editor that tried to replace it.
- [Reading logs before guessing](http://localhost:3000/reading-logs-before-guessing.md): One observed value beats thirty minutes of plausible theories.
- [Small commits](http://localhost:3000/small-commits.md): The commit is the undo button; keep it within reach.
- [Feeds still work](http://localhost:3000/feeds-still-work.md): RSS and Atom are the quietest, most durable way to publish.
- [Tests for the next person](http://localhost:3000/tests-for-the-next-person.md): A test is a sentence about behaviour that a machine keeps true.
- [Deploying a directory](http://localhost:3000/deploying-a-directory.md): How this site ships: build, then copy a folder.
- [What llms.txt is for](http://localhost:3000/what-llms-txt-is-for.md): A short index that tells a language model where the readable versions of your pages are.

## Pages

- [About](http://localhost:3000/about/)
- [Tags](http://localhost:3000/tags/)