There are so many little gems in this piece by Yevgeniy Brikman all about documentation. He digs into a lot more than simply documenting code though and focuses on how we can document every phase of our work, from design to process and beyond.
Here’s my favorite lines that made me sit back and shout “Wahoo!”:
When a developer uses your code, they are really learning a new language, so choose the words in it wisely.
…programs must be written …