Alex Garnett Write The Docs Docs Ai Tooling Is Better And Better For Us 2025
-
Can’t open LinkedIn without being smothered with AI.
-
Even if you like it, you’re exhausted.
-
AI is good for small and discrete tasks - Helm Chart.
- If you know what you look at, it is better.
-
Most popular AIs are known to hallucinate.
-
As a writer, you get mixed / negative feelings.
-
William Butler Yeats - there is no way we can go on longer - The Second Coming.
- Surely some revelation is at hand.
-
Its the future and you’re suffering.
-
Don’t Talk to me about AI. I will kill myself.
-
On LinkedIn - what’s our AI strategy? - have we tried vibe coding?
-
How AI is transforming the future of SEO.
-
Using AI to use Vale rules or other style linting.
-
Ask yourself - what part of your job do you like the best?
- Figure out how to save time on other stuff and spend time on what you enjoy.
-
Reactivity is the worst part of Docs writing.
-
No time to think about UX and just want to get features documented.
-
Want to be doing the intellectually satisfying part of their work.
-
-
Retrieval Augmented Generation - pointing a pre-trained AI model toward a different corpus.
- Want to point toward another corpus.
-
Docs and Support Vendors - InKeep and Kapa.
-
kapa.ai - turn your docs into a reliable LLM chatbot.
-
Temporal - commercial open source project.
-
Ask AI button - takes you to the Kapa interface.
-
kapa.ai - uncertain - unsure about the answer is it giving and flags that.
-
-
Docs AI was implemented by a Support Engineer.
-
Some work is thoughtful, some is repetitive - Support Engineer
- The computer is for driving new routes.
-
Support + Docs + Community want to work together at companies.
-
kapa.ai scrapes Discourse forum. Kapa is very citation-driven.
- Does source analytics.
-
Good docs AI - Valid Citations - only and always.
-
Take an evaluation-centric approach to results.
-
Close the feedback loop - let the AI improve your docs in turn.
-
You should not have to simplify your docs for AI’s sake, don’t move away from best practices.
-
-
Support the vendors you trust.
-
Credibility is formed by consensus.
-
Rejecting new technology out of hand is not going to help.
-
Does not mean compromising on your work or your professionalism.
-
Kapa works with many AI models - rotate off results seeing in different context.
- Not needing to chase ChatGPT revisions etc.
-
Nothing is more to Docs than context.
-
More than just copyediting.
-
Synthesising and locating concepts in existing knowledge is the best.
-
If I don’t trust the AI to provide good context, hate the AI. If you do trust, then it is good.
-
-
kapa.ai groups the questions together.
-
If you don’t explicitly say something doesn’t work, AI doesn’t infer.
-
The AI made more work for us - improve documents with actual analytical data.
-
Dostoevsky - The Double - AI is a 19th century problem and we’ve deal with this before.
-
AI is not only a Docs writing tool.