2024 Machine Learning Review (For Technical Writers)

There are 3 intractable challenges in technical writing. I do not believe we will ever be able to completely solve these challenges using only the practices and technologies of the 2010s.

Machine learning (ML) has the potential to advance the state of the art in technical writing. No, I'm not talking about text generation models. The ML technology that might end up having the biggest impact on technical writing is embeddings. What embeddings offer to technical writers is the ability to discover...

I’m building a web crawler so that I can track how pages in my docs site link to each other and to the outside web more broadly. If a lot of my docs pages link to some particular page, then that page is probably important. PageRank Lite, basically, except with much more focus on intra-site backlinks.

A quote from Every Page Is Page One that has deeply changed how I approach technical writing.

I have been tasked with the fascinating and somewhat-overwhelming project of migrating pigweed.dev's build system from GN to Bazel. These are my notes on the project.