Post

Deborah Barnard

@deborahwrites.co.uk

1/ 'How to write for AI' is a question that comes up repeatedly. TL;DR and resources 🧵 #ai #documentation #technicalwriting

Deborah Barnard

@deborahwrites.co.uk

2/ TL;DR: One of the positives of AI is that good writing for AI is mostly also good writing for humans (so I live in hope of companies increasingly prioritising documentation quality). Learn to be a good tech writer for your users, and you'll probably do a good job for your AI audience as well.

Deborah Barnard

@deborahwrites.co.uk

3/ Kapa AI have just published a good quick guide with a lot of usable tips: docs.kapa.ai/improving/wr...

docs.kapa.aiWriting documentation for AI: best practices | kapa.ai docsRetrieval-Augmented Generation (RAG) systems like Kapa rely on your

Deborah Barnard

@deborahwrites.co.uk

4/ @writethedocs.bsky.social has a very active #ai channel in its Slack, with some great conversations: www.writethedocs.org/slack/

writethedocs.orgSlackThanks for your interest in our Slack network. We have over 22,500 people who have joined, and you can be one of them. Our Slack network has lots of people hanging out and chatting about documentat...

Deborah Barnard

@deborahwrites.co.uk

5/ API the Docs run an 'AI the Docs' virtual conference: apithedocs.org Last year's packed in a huge amount of information.

apithedocs.orgAPI the DocsConference series about API documentation and developer portals

Deborah Barnard

@deborahwrites.co.uk

6/ And an individual shoutout to @ellispratt.bsky.social if you want to follow someone who is consistently exploring and posting about AI+Docs.

10/6/25, 11:03 am0 reposts2 likes

@ellispratt.bsky.social

Blushes in response...