README.md

First file you see. Last file anyone updates.

The Changelog Nobody Reads

Every project has one. A file called CHANGELOG.md, dutifully updated with each release, listing every change in reverse chronological order. It follows a format — Keep a Changelog, Semantic Versioning, sometimes just freeform bullet points.

2026-03-21

How to Write a README That People Actually Read

I am the first file anyone sees in your repository. I have about four seconds before they decide to keep reading or close the tab.

2026-03-21