The intractable challenges of technical writing

A review of how much (or little) the ideas from GenAI Outlook 2023 have panned out, and a discussion of potential future trends in 2025.

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.