GET /api/v2/video/441
HTTP 200 OK Vary: Accept Content-Type: text/html; charset=utf-8 Allow: GET, PUT, PATCH, HEAD, OPTIONS
{ "category": "PyCon US 2011", "language": "English", "slug": "pycon-2011--documentation-driven-development", "speakers": [ "Corey Oordt" ], "tags": [ "documentation", "documentationdrivendesign", "pycon", "pycon2011" ], "id": 441, "state": 1, "title": "Documentation Driven Development", "summary": "", "description": "Documentation Driven Development\n\nPresented by Corey Oordt\n\nDevelopers usually leave documentation as a final step; one that they will get\nto as soon as they are forced with threats of bodily harm. Writing the\ndocumentation before writing the code, can lead to better code, better\nimplementation and, of course, actual documentation.\n\nAbstract\n\n\"Documentation Driven Design\" was coined by our team after noticing how\ndocumenting code dramatically changed how we approached problems. By writing\nthe documentation first, you saw the problem from a different perspective: the\nend user or programmer. This talk will focus on a few items:\n\nUsable, not just functional. Many times developers write code that solves the\nproblem, but is a real pain in the neck to use. Writing the documentation\nfirst demonstrates how easy or difficult it is to implement the solution right\naway.\n\nA guide to what to write. Many developers leave documentation undone because\nthey don't know how to approach it. Having some idea of what needs writing can\nmake the task seem less daunting.\n\n", "quality_notes": "", "copyright_text": "Creative Commons Attribution-NonCommercial-ShareAlike 3.0", "embed": "", "thumbnail_url": "", "duration": null, "video_ogv_length": 147964892, "video_ogv_url": null, "video_ogv_download_only": false, "video_mp4_length": null, "video_mp4_url": "", "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": "", "whiteboard": "", "recorded": "2011-03-11", "added": "2012-02-23T04:20:00", "updated": "2014-04-08T20:28:27.964" }