Resources: Writing for AI
A quick round-up of resources for tech writers on writing for AI.
Writing for AI means making sure your docs are easy for AI to consume. Think of AI crawlers as another type of user, alongside humans and SEO crawlers.
The good news: the TL;DR of most discussions is that good docs for humans (plain language, well structured, semantic HTML and so on) are also good docs for AI.
You should consider adding an llms.txt file to your site. llms-txt is:
A proposal to standardise on using an /llms.txt file to provide information to help LLMs use a website at inference time.
Learning resources:
- There's a virtual event, AI the Docs, run by the API the Docs folks. The recordings from last year are here: AI the Docs 2024. The event is running again this year: AI the Docs 2025. I attended last year - have to admit I didn't watch every talk (they crammed a lot in) but there were some useful ones in the mix.
- The
#aichannel in the Write the Docs Slack is very active. - For paid courses, CherryLeaf offer a course in Using Generative AI in Technical Writing. I haven't tried it yet, but Ellis Pratt who runs the course is active in Write the Docs and very engaged on this topic.
Your Product Needs Words