GET /api/v2/video/
HTTP 200 OK Vary: Accept Content-Type: text/html; charset=utf-8 Allow: GET, POST, HEAD, OPTIONS
{ "count": 83, "next": "http://videos.writethedocs.org/api/v2/video/?page=2", "previous": null, "results": [ { "category": "NA 2015", "language": "English", "slug": "documentation-disrupted-how-two-technical-write", "speakers": [ "Riona MacNamara" ], "tags": [], "id": 92, "state": 1, "title": "Documentation, Disrupted: How Two Technical Writers Changed Google Engineering Culture", "summary": "", "description": "Last year, we were inspired to action by a presentation at Write the Docs. This talk will tell the story of what happened next: how, in two quarters, we worked with a small self-forming team of amazing writers and engineers to build a platform in six months is well on the way to becoming a part of the standard Google engineering workflow. We\u2019ll share how that platform transformed our role as technical writers and our relationship with engineering. We\u2019ll cover design and implementation details, but we\u2019ll also talk about our experience - how we learned that being audacious (but not reckless), focused (but open and generous), and unafraid could revitalize our whole approach to work and save us from burnout.\r\nWe&#39;ll talk about our ever-growing appetite for disruption: How it changed beyond recognition our relationships with engineers, fellow writers, and senior leadership, making us fall in love again with our roles as documentarians.", "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": 1678, "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/Documentation_Disrupted_How_Two_Technical_Writers_.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/EnB8GtPuauw", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:48.447", "updated": "2015-05-20T21:52:07.170" }, { "category": "NA 2015", "language": "English", "slug": "elevating-the-hedgehog-creativity-in-tech-writin", "speakers": [ "Tana Franko" ], "tags": [], "id": 93, "state": 1, "title": "Elevating the Hedgehog: Creativity in Tech Writing", "summary": "", "description": "&quot;People who hope to thrive in the Conceptual Age must understand the connections between diverse, and seemingly separate, disciplines.&quot; So says Daniel Pink in his book, A Whole New Mind: Why Right-Brainers Will Rule the Future. In this talk, I assert that tech writers are a natural fit to help their organizations transition from the Information Age to the Conceptual Age. I&#39;ll also give and seek ideas on how we as writers can apply Pink&#39;s six aptitudes -- storytelling, empathy, design, humor, games, and finding meaning -- to make our work more fulfilling, if not more competitive.\r\nThe key underlying message for those who attend this talk is: YOU are a designer. Even if you haven&#39;t traditionally seen yourself in this role, writers are information designers who serve a unique, user-focused and holistic function on development teams. By recognizing that fact, and opening up space in your work life for creativity, you can have an even bigger impact and a more fulfilling career.", "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": 1316, "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/Elevating_the_Hedgehog_Creativity_in_Tech_Writing.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/jwN2aAq4wGw", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:50.352", "updated": "2015-05-20T21:52:08.488" }, { "category": "NA 2015", "language": "English", "slug": "entry-points-and-guide-posts-helping-new-contrib", "speakers": [ "Janet Swisher" ], "tags": [], "id": 91, "state": 1, "title": "Entry points and guide posts: Helping new contributors find their way", "summary": "", "description": "How did Mozilla Developer Network (MDN) achieve a 46% increase in active editors and a 90% increase in translation contributions in 2014? Many factors helped, but a major element was the support we added for new contributors.\r\n\u201cScratch your own itch\u201d is the proverbial invitation to contribute to open source projects. How well this works for contributing to code is open to debate, but it rarely makes sense for open source documentation, especially for well-established projects. Not only is it unhelpful for the project, which typically has plans (or at least wishlists) for improving the docs, but it provides very little guidance to the contributor as to what they might do, what they personally are able to do, and what would be most helpful to do.\r\nIn the 10 years that MDN has been a wiki (some of the content pre-dates the wiki), the community has always welcomed constructive contributions by anyone who bothers to create a user account. Over the years, we\u2019ve created meta-documentation about contributing to the site, including wishlists of things we\u2019d like to see documented. However, these didn\u2019t necessarily help newcomers gain traction.\r\nOnly in the last year or so have we created documentation to help new contributors specifically. Our aim is to help newcomers find the right match among:\r\nTopics and tasks the person is interested in (what they like)\r\nTasks the person has the skills and time to do (what they can do)\r\nTasks that help MDN meet the goals that Mozilla has set (what we need/want)\r\nI\u2019ll describe the features we\u2019ve put in place to achieve this, as well as things we\u2019re still working on. I\u2019ll leave space for discussion so we can all share ideas and successes.", "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": 1381, "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/Entry_points_and_guide_posts_Helping_new_contribut.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/VG-uvJDBTdM", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:46.493", "updated": "2015-05-20T21:52:05.943" }, { "category": "NA 2015", "language": "English", "slug": "how-github-uses-github-to-document-github", "speakers": [ "Garen J. Torikian" ], "tags": [], "id": 96, "state": 1, "title": "How GitHub uses GitHub to document GitHub", "summary": "", "description": "Everyone knows that GitHub is the place to host your project&#39;s code. What you may not know is that the same workflow developers use to create, update, and manage their software is also used to create, update, and manage GitHub&#39;s documentation.\r\nhttps://help.github.com is GitHub&#39;s second-most viewed site--after the main website itself. I&#39;d like to provide a somewhat opinionated look on how our valiant Documentation team writes and releases content for features on GitHub.com and GitHub Enterprise. I&#39;ll go over:\r\nHow our teams (Development, Security, Docs, etc) coordinate before launching a feature\r\nThe importance of opening pull requests early\r\nThe review/edit cycle with peers\r\nHow we incorporate DITA best practices into our Markdown documentation\r\nValidating content through CI and automated tests\r\nHow we incorporate feedback from our users", "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": 1400, "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/How_GitHub_uses_GitHub_to_document_GitHub.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/s46m8H4BrrE", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:56.785", "updated": "2015-05-20T21:52:12.272" }, { "category": "NA 2015", "language": "English", "slug": "keep-em-playing", "speakers": [ "Torrey Podmajersky" ], "tags": [], "id": 99, "state": 1, "title": "Keep 'em playing", "summary": "", "description": "When people have to stop to understand labels and instructions, they can&#39;t stay engaged in their experiences. My job shipping Xbox One was to use words so well, people wouldn&#39;t notice them at all. In this talk, I&#39;ll show the only 3 reasons I use words in user interfaces, how I find the right words, and how I increase engagement by respecting people\u2019 intent.", "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": 1720, "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/Keep_em_playing.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/AMRfkcmyc40", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:32:02.481", "updated": "2015-05-20T21:52:15.958" }, { "category": "NA 2015", "language": "English", "slug": "keynote-the-federated-wiki", "speakers": [ "Ward Cunningham" ], "tags": [], "id": 90, "state": 1, "title": "Keynote: The Federated Wiki", "summary": "", "description": "Just as the first wiki changed how people write, our new wiki will change how people work. By pushing steadily on two fundamental ideas, refactoring to ease improvement and federation to ease sharing, we have once again uncovered a simpler and more powerful internet.", "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": 2807, "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/Keynote_The_Federated_Wiki.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/3nB8ml6UowE", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:44.632", "updated": "2015-05-20T21:52:04.734" }, { "category": "NA 2015", "language": "English", "slug": "lightning-talks-0", "speakers": [], "tags": [], "id": 94, "state": 1, "title": "Lightning Talks", "summary": "", "description": "", "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": 2414, "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/Lightning_Talks_10.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/W7H3njxsodM", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:52.886", "updated": "2015-05-20T21:52:09.753" }, { "category": "NA 2015", "language": "English", "slug": "martial-arts-philosophy-forged-an-ad-hoc-writing", "speakers": [ "Gaylin Walli" ], "tags": [], "id": 97, "state": 1, "title": "Martial Arts Philosophy Forged an Ad Hoc Writing Team that Writes Great Docs", "summary": "", "description": "At Fastly, a San Francisco-based content delivery network startup company, I\u2019ve learned that almost every one of my co-workers, regardless of their job function, is willing to write our company\u2019s documentation. Whether they realize it or not, each one of them has ventured onto the path of becoming a \u201cwriting team black belt.\u201d\r\nIn this talk I\u2019ll discuss how my company has unwittingly followed the seven (and a half) rules I normally associate with becoming a great martial artist. I\u2019ll discuss how we\u2019ve been using these rules to forge an amazing ad-hoc documentation team with no formal department and no squad of strategically placed technical writers. I\u2019ll talk about how my company has managed it despite the obstacles of startup life, including moving seven times and growing from less than 30 employees when I first joined to a throng of more than 150 a mere year and a half later. Finally, I\u2019ll point out some of our successes, a few of our failures, and how each of the seven (and a half) rules has taught us what it means to write Fastly.", "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": 900, "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/The_Making_of_Writing_Black_Belts_How_Martial_Arts.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/4PP2xBsMWKw", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:58.722", "updated": "2015-05-20T21:52:13.505" }, { "category": "NA 2015", "language": "English", "slug": "start-your-own-write-the-docs-meetup-group", "speakers": [ "Mike Jang" ], "tags": [], "id": 98, "state": 1, "title": "Start Your Own Write The Docs Meetup Group", "summary": "", "description": "With just a little work, you can feel the joy of Write The Docs all year!\r\nI started the Write The Docs PDX Meetup Group back in May of 2014, just after last year\u2019s conference. As the only writer in my office, I often feel alone. At Write The Docs NA 2014 conference, I felt the joy of interacting with documentarians like myself, people who were facing similar challenges. I wanted to continue feeling that joy.\r\nI\u2019ll describe my experiences creating a Write The Docs Meetup group in Portland. I\u2019ll show you how easy* it is to create a Meetup group, attract members, get sponsors, find speakers, and make sure all members of your group feel welcome. I\u2019ll tell you about the Meetups we\u2019ve had, and what we learned from each other.\r\nMore importantly, I\u2019ll lay out the ways you can continue the conversation we&#39;ve had during WTD 2015. I&#39;ll share my best practices for excellent Meetups for Documentarians.\r\n*Yes, \u201ceasy\u201d is a euphemism for a lot of hard work. But the people you&#39;ll meet and the contacts that you&#39;ll make can reward you and your company in other ways.", "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": 942, "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/Start_Your_Own_Write_The_Docs_Meetup_Group.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/ZwQ8Kd48d0w", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:32:00.613", "updated": "2015-05-20T21:52:14.725" }, { "category": "NA 2015", "language": "English", "slug": "success-is-more-than-not-failing", "speakers": [ "Heidi Waterhouse" ], "tags": [], "id": 100, "state": 1, "title": "Success is more than not-failing", "summary": "", "description": "We talk a lot about minimum viable products, and building our products up from small features. We talk a lot about failure, and how to learn from it and not replicate failures over and over again. But what I haven\u2019t heard a lot of discussion about is how we know we\u2019ve succeeded. Is it market share? Usable product? Could understanding and setting a measurable, achievable goals help us overcome imposter syndrome, second sock syndrome, and feature creep?\r\nThis talk provides some metrics on identifying success, documenting what it will look like when you get there, preserving the idea, and dealing with the inevitable distractions and changes in direction that may prevent you from ending up where you expect.\r\nI plan to speak on how documentation can serve a crucial function at both defining and driving success. We need to stop believing that agile is the end of the answer and embrace it as part of building what we want to have in the end.\r\nContinuous improvement can have a victory condition, if we build it.", "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": 2055, "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/Success_is_more_than_notfailing.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/mkyeF2YSRl8", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:32:04.340", "updated": "2015-05-20T21:52:20.237" }, { "category": "NA 2015", "language": "English", "slug": "what-can-brownfield-do-for-you", "speakers": [ "Mo Nishiyama" ], "tags": [], "id": 95, "state": 1, "title": "What Can Brownfield Do For You?", "summary": "", "description": "As documentarians, we are rarely afforded an opportunity to thrive in a pristine greenfield environment. Sometimes we are asked to resurrect an existing documentation system which had fallen into a derelict state over many years. To turn this ship around, we must shepherd contents, customer base, and internal Subject Matter Experts into a future state where outdated, neglected, and ambiguous support documents are transformed into timely, relevant, and pleasing works of art.\r\nThe role of the documentarian is to help execute this transformation. However, we are often asked (or voluntold) by our organizations to wear other hats beyond our primary writing duties: repair and build relationships, analyze business processes, learn about how others react to change, discover unknown troves of documentation, train and encourage the next generation of writers, gather and crunch data, tell stories, design workflows, and perform \u201cother duties as needed.\u201d Some may respond with an exasperated \u201cI wasn\u2019t trained on this!!!\u201d or \u201cThat\u2019s not part of my job!\u201d But those of us who embrace the opportunity to stretch beyond our areas of expertise and learn new peripheral skills may realize that working on a documentation equivalent of a cleaning up Superfund site can turn into super fun.\r\nIn this talk, I will share my experiences and lessons learned as a technical writer who is witnessing this documentation culture change, one conversation at a time. Wearing many hats can be exhilarating and rewarding.", "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": 1536, "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/What_Can_Brownfield_Do_For_You.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/3X8xyfkRmO4", "whiteboard": "", "recorded": "2015-05-19", "added": "2015-05-20T21:31:54.828", "updated": "2015-05-20T21:52:11.038" }, { "category": "NA 2015", "language": "English", "slug": "a-brief-history-of-math-writing-symbol-structur", "speakers": [ "Alfonso Roman", "Emily Hoffmann" ], "tags": [], "id": 85, "state": 1, "title": "A brief history of math writing: symbol, structure, and proof", "summary": "", "description": "A mathematical proof is a logically rigorous way of showing that something is true. It begins with a statement of the desired result and any assumptions that must be made. It guides the reader through a set of logical sequential steps, supported by figures to aid intuition or cross-references for prerequisite knowledge. It ends by declaring that the desired result has been achieved. At risk of insulting every mathematician who ever lived, in many ways a proof is not so different from a grand, abstract how-to document.\r\nPerhaps surprisingly, for most of human history mathematical proofs and mathematics itself have been written in prose. Even those of us who cringe at the memory of high school algebra can agree that \u201c10x + y^2 = 3\u201d is more user-friendly than \u201cthe sum of an unknown quality multiplied by ten and another unknown quantity multiplied by itself is equal to three\u201d. The first part of this talk explores the development of mathematical writing, which can be divided into improvements in symbolic representation and improvements in structure. This discussion is partly inspired by Bret Victor\u2019s observation that the most influential breakthroughs in the history of mathematics were actually breakthroughs in \u201cUI design\u201d, for example the invention of arabic numerals (0, 1, 2, 3,...) as a replacement for clunky roman numerals (I, II, III, IV\u2026).\r\nProofs and rigorous documentation empower their readers to greater understanding by never relying on authority or persuasion. A mathematical proof, unlike a scientific experiment or a souffle recipe, must show that the desired result is always achieved when the right steps are executed under the right conditions. Users of computer applications certainly expect documentation to live up to the same standards. The second part of this talk explores the concept of mathematical proof in more depth. We will look at how proofs are structured and use logic in a particular way to minimize ambiguity and maximize credibility, and how the writing process is itself a powerful tool to root out hidden assumptions and errors in thinking.", "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": 1730, "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/A_brief_history_of_math_writing_symbol_structure_a.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/3PbkglMkzS0", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:35.043", "updated": "2015-05-20T21:51:58.377" }, { "category": "NA 2015", "language": "English", "slug": "a-developers-approach-to-documentation-from-pass", "speakers": [ "Gregory Koberger" ], "tags": [], "id": 84, "state": 1, "title": "A Developers Approach to Documentation: From Passive to Dynamic", "summary": "", "description": "The era of O\u2019Reilly books is done, finito, kaput. With so much of the developer experience online, we know a great deal about each individual user and about the code we document. Why, then, do we documentarians persist in providing the same walls of text to each of our readers, especially when there are so many more personalized ways of describing technical tools and code?\r\nThis talk addresses the move from passive to dynamic documentation. As code goes mainstream, more and more consumers of APIs and technical writing will be non-technical. Technical writing bears a responsibility to reduce the learning curve as much as possible for these readers, and it can do that by being much more intimate about its relationship with them.", "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": 1708, "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/A_Developers_Approach_to_Documentation_From_Passiv.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/5lw8RFy3YNA", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:33.144", "updated": "2015-05-20T21:51:57.138" }, { "category": "NA 2015", "language": "English", "slug": "designing-information-for-growth", "speakers": [ "Marya DeVoto" ], "tags": [], "id": 88, "state": 1, "title": "Designing Information for Growth", "summary": "", "description": "Every tech company or organization organically produces docs in some form, but as scale increases, the information design decisions you started with will almost certainly serve some information consumers better than others. Depending on who&#39;s creating information and who&#39;s using it, the approach to designing and delivering information can be dramatically different, with very different outcomes that probably won&#39;t work across an entire larger organization. Be aware of the information design decisions you&#39;re making so you can plan for growth. Design by default is not a good strategy!\r\nThis talk discusses how:\r\nInformation inherently includes design, whether or not you meant to do it. Information also requires design, no matter how simple and straightforward it may seem.\r\nTechnical information can be roughly sorted into modes such as descriptive, defensive, procedural, and tutorial. (These are different from concept-task-reference.)\r\nEach of these modes has different design implications that address different audiences and needs.\r\nBeing aware of your design priorities can help you understand how to make your stakeholders happier as your documentation base grows with the organization.", "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": 1905, "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/Designing_Information_for_Growth.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/-y4itLMwX8g", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:40.844", "updated": "2015-05-20T21:52:02.201" }, { "category": "NA 2015", "language": "English", "slug": "how-to-write-documentation-for-people-that-dont", "speakers": [ "Kevin Burke" ], "tags": [], "id": 82, "state": 1, "title": "How to Write Documentation for People that Don't Read", "summary": "", "description": "It&#39;s 3AM, do you know where your users are? If people want to learn how to use your product, where are they looking for help? Are they on your site, and if they&#39;re on your site, are they finding the right page?\r\nUsability researchers have known for decades that users don&#39;t read word by word - they scan for the content they want.\r\nIf users can&#39;t make heads or tails of your documentation, they&#39;ll give up (a loss of revenue), remain ignorant of product features (another loss of revenue) or ask needless support questions (an increased cost).\r\nIn this talk we&#39;ll examine the findability of your documentation, and the text on the pages in your documentation. We&#39;ll examine usability research into how users read, look at several ways your documentation is failing busy users, and the lessons I learned conducting user tests at Twilio. We&#39;ll learn more about how users find the answers they are looking for, and the importance of spreading clear writing across not just your documentation, but your headlines and error messages in your API.", "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": 1732, "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/How_to_Write_Documentation_for_People_that_Dont_Re.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/sQP_hUNCrcE", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:29.109", "updated": "2015-05-20T21:51:54.601" }, { "category": "NA 2015", "language": "English", "slug": "introduction-0", "speakers": [ "Eric Holscher" ], "tags": [], "id": 78, "state": 1, "title": "Introduction", "summary": "", "description": "", "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": 813, "video_ogv_length": null, "video_ogv_url": "", "video_ogv_download_only": false, "video_mp4_length": null, "video_mp4_url": "http://64966d3674e0a64d8f4a-47c94b14ef8e1f83d5390cdb0629c6ed.r53.cf2.rackcdn.com/wtd-2013/Introduction_3.mp4", "video_mp4_download_only": false, "video_webm_length": null, "video_webm_url": "", "video_webm_download_only": false, "video_flv_length": null, "video_flv_url": "", "video_flv_download_only": false, "source_url": "http://www.youtube.com/watch?v=UKY3scPIMd8", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:20:33.454", "updated": "2015-05-20T21:48:21.542" }, { "category": "NA 2015", "language": "English", "slug": "keynote-we-are-all-abbott-and-costello", "speakers": [ "Marcia Riefer Johnston" ], "tags": [], "id": 79, "state": 1, "title": "Keynote: We Are All Abbott and Costello", "summary": "", "description": "Documentarians and technical writers have seen many changes in our professions in recent years, and there\u2019s no sign of change slowing down. One thing endures: the writer&#39;s goal of communicating to understanding. It\u2019s not as easy as it sounds. Because we are all Abbott and Costello.", "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": 2382, "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/Keynote_We_Are_All_Abbott_and_Costello.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://www.youtube.com/watch?v=UKY3scPIMd8", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:26:14.421", "updated": "2015-05-20T21:51:50.821" }, { "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" }, { "category": "NA 2015", "language": "English", "slug": "lightning-talks", "speakers": [], "tags": [], "id": 83, "state": 1, "title": "Lightning Talks", "summary": "", "description": "", "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": 1690, "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/Lightning_Talks_9.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/Lbug4C6ao_M", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:31.261", "updated": "2015-05-20T21:51:55.852" }, { "category": "NA 2015", "language": "English", "slug": "tech-writing-in-a-continuous-deployment-world", "speakers": [ "Christine Burwinkle" ], "tags": [], "id": 89, "state": 1, "title": "Tech writing in a continuous deployment world", "summary": "", "description": "Here at Atlassian, we\u2019ve been moving ever closer to a world of continuous deployment for our software products. Five years ago, releases took months. Now, many products are releasing every two weeks at a minimum. In addition, the past year has seen features being deployed as soon as they pass testing. What\u2019s a tech writer to do!?\r\nIn true agile fashion, the response to these challenges varies across products and writers within Atlassian. This gives us a breadth of stories and examples I can share about our experiences in this world. Here\u2019s a high-level look at what I\u2019ll share:\r\nA brief discussion of continuous deployment: what does it mean, especially for tech writers and others involved in the process?\r\nA look at some things that have worked for us. Making the mental shift from releases to features has been an absolute necessity. We\u2019ve also had to change the tooling we use, the processes we follow, and the way we communicate. This journey has also forced us to consider what the documentation equivalent of an MVP (minimal viable product in Agile development) looks like.\r\nThere are a few things that haven\u2019t worked out very well! Resource-heavy deliverables (like videos and tutorials) are really difficult to maintain. Communication also increases in importance in a rapidly-paced cycle. These and other areas provide us with some good lessons learned.\r\nThe jury is still out on a few experiments! Things like investing more heavily in in-app help and automating doc publication in tandem with code deployment are among the experiments we\u2019re attempting to get better at this new world.", "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": 1624, "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/Tech_writing_in_a_continuous_deployment_world.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/Bsod_z9OKQY", "whiteboard": "", "recorded": "2015-05-18", "added": "2015-05-20T21:31:42.673", "updated": "2015-05-20T21:52:03.456" } ] }