card file · JAI-18
ai conversations / ai operations
card 18 of 73
Documentation
document and share knowledge about how ai is used
When AI use lives only in people's heads, it is hard to review, repeat, or explain. This card is about writing down how AI is used, what choices were made, and where to find that knowledge. A team pauses here when no one can quite say how a tool ended up in the workflow.
Questions to explore
// use these as prompts in a workshop or on your own. There are no right answers.
- What about your AI use is written down today, and what lives only in memory?
- Where would a new colleague look to understand how AI fits into your work?
- How do you record which tool was used for a given piece of published work?
- What would you struggle to explain if a reader or editor asked how something was made?
- Who keeps your AI documentation current, and how often is it reviewed?
Expert voices
// notes from the journalists and AI experts who helped shape this kit
“Document which tools were tested and what was learned. A shared repository of experiences keeps every team from starting at zero.”
Ola Möller and Barbara Gruber, MethodKit and DW Akademie
Things to consider
- Notes written during the work are more accurate than notes written afterward.
- Documentation that no one can find does not do its job.
- Recording why a choice was made matters as much as recording what was done.
using this card
Pull Documentation when it is relevant and set it aside when it is not. Pair it with the other AI Conversations cards, lay them out on a table, and use the questions above to get everyone on the same page. Capture what you discuss on sticky notes or in a shared doc.
More AI Conversations cards
~/library/ai-conversations
JAI-01

Tools
the tools, services and ai solutions you use
JAI-02

AI Fundamentals
main concepts you need to know related to ai
JAI-03

Use Cases
examples of how ai can strengthen journalistic work
JAI-04

Skills
what you know and need to learn to work with ai
JAI-05

Purpose
why you use ai and what your intention is
JAI-06

Hopes
what you hope ai could do for your work and organization