card file · JAI-18 ai conversations / ai operations card 18 of 73
Documentation card
category: ai conversations section: ai operations page: /card/documentation

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.
  1. What about your AI use is written down today, and what lives only in memory?
  2. Where would a new colleague look to understand how AI fits into your work?
  3. How do you record which tool was used for a given piece of published work?
  4. What would you struggle to explain if a reader or editor asked how something was made?
  5. 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