As important as code is, documentation of that code is arguably more important. No developer, and no software, exists in a vacuum; unless other developers can understand the code you’ve written, it loses much of its potential impact.
But what about machines? Do they also need good docs?
The answer is yes, and points to a future of “tiered documentation,” a term I first saw described by Vlad Ionescu. As he details, tiered documentation means “having one set of documentation for human users and having another set of documentation specifically for LLM [large language model] training.”