When Wishing Still Helped... What Folklore Can Teach Us About Technical Writing

on YouTube ↗43m

" summary

Argues that folktale structure maps to agile user stories and that rewriting docs around concrete user stories produces clearer procedures. Shows actual OpenShift user stories like as a cluster administrator I want to know how to collect relevant openshift debug data efficiently, transforms them into a gathering data about your cluster for red hat support procedure, and traces the recurring three tasks motif from fairy tales into docs. Uses contextual inquiry and usability testing as tools and reports improved, task-focused documentation.

AI-written summary · about

" chapters (5)

1. 0:00Start
2. 2:52What is a user story?
3. 9:53GRIMM'S FAIRY TALES
4. 24:08Structured tasks and a predictable story
5. 25:06How folktales can improve how we use personas Red Hat's main personas

" related talks

• 21mTelling the Full Story - Use Cases and User StoriesLauren Kelly · DrupalCon Amsterdam 2019
• 34mDocumentation Thinking Beyond the Docs: Lessons from Decision-Facing Technical WritingMary Elise Dedicke · Write the Docs Portland 2026
• 13mWe’re Not in Kansas Anymore: How to Find Courage while Following the Technical Doc RoadChristy Lutz · Write the Docs North America 2016
• 01h 24mWriting Documentation - Practices and TheoryLlewellyn Falco · Craft Conference 2023
• 48mBeyond Words: Crafting User-Friendly DocumentationZainab Daodu · FOSS Backstage 2025
• 39mThe Documentation Dream: One Team, No Silos, Shared GoalDominika Borges, Aneta Šteflová Petrová · DevConf.CZ 2025
• 22mUncharted waters: Documenting emerging technologyAndrew Burden · DevConf.CZ 2020
• 33mWhat The Doc?!?! How to Write and Read Documentation That Allows You To Get Sh*t Done!Kim Crayton · SeleniumConf Berlin 2017