GET /api/v2/video/81
HTTP 200 OK Vary: Accept Content-Type: text/html; charset=utf-8 Allow: GET, PUT, PATCH, HEAD, OPTIONS
{ "category": "NA 2015", "language": "English", "slug": "lets-tell-a-story-scenario-based-documentation", "speakers": [ "Matt Ness" ], "tags": [], "id": 81, "state": 1, "title": "Let\u2019s Tell a Story: Scenario-Based Documentation", "summary": "", "description": "To new users, complex software products can seem like dark woods on a stormy day. As tech writers, we often spend a lot of time talking about the overall shape of the forest and the variety of paths within it (conceptual docs), creating detailed catalogs of local tree species (reference docs), and providing step-by-step guides to things like \u201chow to cross a river\u201d or \u201chow to knock on a door\u201d (task-based docs).\r\nBut none of that helps your customers when they just want to know how to get to Grandmother\u2019s house, without getting lost in the forest, falling into the river, and accidentally going to the other cabin in the woods, where the lycanthropic senior citizens live.\r\nIn other words, your customers need a narrative. And maybe they need lots of them. When you\u2019re dealing with products that can be run and configured in a bewildering variety of ways, a single getting started manual might not do the trick. It\u2019s like giving people a Choose Your Own Adventure book and only allowing them to choose one path through to the end.\r\nFor my talk I\u2019ll explain how we became aware of the need for better scenario-based documentation, and how we ended up building a prototype during a hack week project. Now we\u2019re on our way to creating a collection of short stories that show users how to string sets of features and procedures together to solve complex problems. We\u2019ll cover some of the things we\u2019ve learned along the way and offer best practices for those who want to tell a few stories of their own.\r\nMatt Ness is a technical writer with over twenty years of experience at places like PeopleSoft, Oracle, and Intuit. He&#39;s currently a writer for Splunk, a leader in the machine data analytics sector.", "quality_notes": "", "copyright_text": "", "embed": "<object width=\"640\" height=\"390\"><param name=\"movie\" value=\"http://youtube.com/v/UKY3scPIMd8?version=3&amp;hl=en_US\"></param><param name=\"allowFullScreen\" value=\"true\"></param><param name=\"allowscriptaccess\" value=\"always\"></param><embed src=\"http://youtube.com/v/UKY3scPIMd8?version=3&amp;hl=en_US\" type=\"application/x-shockwave-flash\" width=\"640\" height=\"390\" allowscriptaccess=\"always\" allowfullscreen=\"true\"></embed></object>", "thumbnail_url": "http://i.ytimg.com/vi/UKY3scPIMd8/hqdefault.jpg", "duration": 1733, "video_ogv_length": null, "video_ogv_url": null, "video_ogv_download_only": false, "video_mp4_length": null, "video_mp4_url": "http://64966d3674e0a64d8f4a-47c94b14ef8e1f83d5390cdb0629c6ed.r53.cf2.rackcdn.com/wtd-2013/Lets_Tell_a_Story_ScenarioBased_Documentation.mp4", "video_mp4_download_only": false, "video_webm_length": null, "video_webm_url": null, "video_webm_download_only": false, "video_flv_length": null, "video_flv_url": null, "video_flv_download_only": false, "source_url": "http://youtu.be/3hneCmLYWjc", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:27.143", "updated": "2015-05-20T21:51:53.351" }