AI must RTFM: Why technical writers are becoming context curators
I’ve been noticing a trend among developers that use AI: they are increasingly writing and structuring docs in context folders so that the AI powered tools they use can build solutions autonomously and with greater accuracy. They now strive to understand information architecture, semantic tagging, docs markup. All of a sudden they’ve discovered docs, so they write more than they code. Because AI must RTFM now.
It’s docs-driven development. It’s also technical writing. We should welcome our colleagues into the fold of technical communication and seriously start thinking about becoming context writers and maintainers. In a way, we’ve always been that, building the skills and techniques that allow owners of brains – either organic or simulated – to find their way in complex systems and accomplish tasks.
All AI requires to do the right thing is great context and a gentle nudge
Picture large language models (LLMs) as elaborate machines that take inputs (in most cases it’s just text), turn it into discrete pieces (tokens) and process it through an incredibly convoluted conveyor belt. At the other end of the machine is the output, usually in the form of helpful commentary, feedback, and commands issued to various system tools. The Chinese room, finally incarnated.
The quality of the output is a function of the quality of the input. We enter requests and get back what an average of all human thoughts could have led us to, eventually. There’s nothing magic to it: if you write clear, accurate, and well structured requests (prompts), chances are that the LLM will respond in kind. It’s hard work, but it pays off, because development time is substantially reduced.
That’s why, with every release of a new LLM, coders pay close attention to the size of the context window, that is, the amount of information one can feed to an LLM. A context window of one million tokens means you can easily feed the entire The Lord of the Rings trilogy to, say, Gemini, and start asking questions about it. And you would still have room for The Hobbit and The Silmarillion.
What is a Context curator and why we need that role
Engineers are finding out that writing, that long shunned soft skill, is now key to their efforts. In Claude Code: Best Practices for Agentic Coding, one of the key steps is creating a CLAUDE.md file that contains instructions and guidelines on how to develop the project, like which commands to run. But that’s only the beginning. Folks now suggest maintaining elaborate context folders.
A context curator, in this sense, is a technical writer who is able to orchestrate and execute a content strategy around both human and AI needs, or even focused on AI alone. Context is so much better than content (a much abused word that means little) because it’s tied to meaning. Context is situational, relevant, necessarily limited. AI needs context to shape its thoughts.
... continue reading