GET /api/v2/video/7
HTTP 200 OK Vary: Accept Content-Type: text/html; charset=utf-8 Allow: GET, PUT, PATCH, HEAD, OPTIONS
{ "category": "NA 2013", "language": "English", "slug": "generating-a-culture-of-doc", "speakers": [ "Leah Cutter" ], "tags": [], "id": 7, "state": 1, "title": "Generating a Culture of Doc", "summary": "How do you encourage engineers to do the write thing? (Not a typo.)\r\nAt Salesforce.com, we now have a team called, \u201cCore Documentation.\u201d We are primarily focused on documenting our internal systems and architecture. Many of us on the team don\u2019t create content: We generate framework, best practices, and training for engineer-created content. (Content can include and is not limited to: code comments, run lists, specs, team web pages, wikis, white papers, architectural diagrams, presentations, etc.)\r\nBut that goes back to the first question\u2013how do you get someone to write, when the word \u201cwriter\u201d isn\u2019t part of their title?\r\nWe\u2019ve been successful using several different venues: - Documentation \u201chack\u201d day \u2013 where engineers spend a day improving their internal doc - Events where posters of different aspects of the architecture are displayed (think art walk, only for engineers) - VERY easy to use templates for readme files, etc. - Lunch meetings/presentations/training/networking - Flattery, appeals to logic (bus factor) and bribes\r\nPlus I would also present some of the things that haven\u2019t worked.", "description": "", "quality_notes": "", "copyright_text": "", "embed": "<object width=\"640\" height=\"390\"><param name=\"movie\" value=\"http://youtube.com/v/v41nPTpXnHQ?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/v41nPTpXnHQ?version=3&amp;hl=en_US\" type=\"application/x-shockwave-flash\" width=\"640\" height=\"390\" allowscriptaccess=\"always\" allowfullscreen=\"true\"></embed></object>", "thumbnail_url": "http://i1.ytimg.com/vi/v41nPTpXnHQ/hqdefault.jpg", "duration": 40, "video_ogv_length": null, "video_ogv_url": "", "video_ogv_download_only": false, "video_mp4_length": null, "video_mp4_url": null, "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": "https://www.youtube.com/watch?v=v41nPTpXnHQ", "whiteboard": "", "recorded": "2013-04-08", "added": "2014-04-28T22:35:50.348", "updated": "2014-04-28T22:35:50.348" }