Place Documentation Formats or Styles into Diataxis Quadrants

Focus on the form and medium: how is the documentation written or presented? What does its format or style tell you about its purpose — to teach, to guide, to explain, or to reference?

You’ll work in teams to classify different documentation formats and style cues using the Diátaxis model. The tutor will draw the Diátaxis coordinate system on the whiteboard:

• One axis: Learning ↔ Doing
• The other: Understanding ↔ Practical

Your task:

1. Read the case on each card — it may describe a format, style, or tool cue (for example, Markdown README with numbered steps, Sphinx autodoc page, video tutorial with voiceover, Obsidian note linking concepts, StackOverflow-style Q&A, etc.).
2. Discuss as a team which quadrant it belongs to.
3. One teammate runs to the board and places the card in the chosen quadrant with an office magnet.
4. Each round, a different person must go — you can’t send the same member twice in a row.
5. The first team to place all cards wins.
6. The tutor awards up to 5 bonus points to the fastest and most justified placements — but only for the winning team.

After the race, take a moment to reflect together on the results:

• Which formats matched their purpose perfectly?
• Which felt “off” — like a tutorial that reads like a reference?
• How do tools (Markdown, wikis, videos, code comments) shape what readers expect?