{"id":3427,"date":"2017-08-28T12:00:07","date_gmt":"2017-08-28T19:00:07","guid":{"rendered":"https:\/\/lookforwardconsulting.com\/?p=3427"},"modified":"2025-09-17T09:56:09","modified_gmt":"2025-09-17T08:56:09","slug":"manage-documents-new-story","status":"publish","type":"post","link":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/","title":{"rendered":"How to manage documents? Should that be a new story?"},"content":{"rendered":"

Continuing with our discussion of documentation<\/a>, I wanted to address how we actually build these documents within our Sprints (or iterations).\u00a0 Remember our key Agile principles<\/a>\u00a0related to documentation: “working software is the primary measure of progress” and “the most efficient and effective method of conveying information to and within a development team is face-to-face conversation.”<\/p>\n

\n
\n

I do NOT recommend having a separate user story for writing documents for multiple reasons.<\/p>\n

    \n
  1. By definition, user stories describe how working software solves a problem, or fulfills a need, for a user.\u00a0 Documents are not software.<\/li>\n
  2. Every user story must be something you can demonstrate.\u00a0 So how do you demonstrate a document to a user?<\/li>\n
  3. A user story needs to be something valuable in the eyes of the user.\u00a0 Certain types of documents, like those specified in a contract or required for statutory reasons, would be considered valuable, but for the most part documents are considered (a sometimes necessary) waste<\/a>.<\/li>\n<\/ol>\n

    Another way to track manage documentation would be through the Definition of Done (DoD)<\/a>.\u00a0 Since the goal every Agile process is to have shippable software at the completion of each iteration, that means in addition to new functionality, the software needs to be appropriately documented.\u00a0 Use the DoD to be 100% clear about what are the documentation requirements in order to say a feature is potentially shippable.\u00a0 Any feature that does not meet the DoD<\/a>\u00a0is not allowed to be demonstrated.<\/p>\n

    Finally, there are no iterations (or Sprints) to create the documentation since that would break the rule that every iteration needs to deliver working software.\u00a0 If a document is needed, I recommend creating it along side with the feature.\u00a0 Remember, most of the technical documentation is contained either in the code or the automated tests.\u00a0 Any other required documentation would be created just-in-time as the feature is close to being completed.\u00a0 I often recommend including the formal review of the documentation (if needed for your product) as part of the acceptance criteria<\/a>\u00a0for the feature.<\/p>\n

    We need to remember that working software is the primary measure of progress of the Agile team.<\/p>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

    Continuing with our discussion of documentation, I wanted to address how we actually build these documents within our Sprints (or iterations).\u00a0 Remember our key Agile principles\u00a0related to documentation: “working software […]<\/p>\n","protected":false},"author":1,"featured_media":6491,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_price":"","_stock":"","_tribe_ticket_header":"","_tribe_default_ticket_provider":"","_tribe_ticket_capacity":"0","_ticket_start_date":"","_ticket_end_date":"","_tribe_ticket_show_description":"","_tribe_ticket_show_not_going":false,"_tribe_ticket_use_global_stock":"","_tribe_ticket_global_stock_level":"","_global_stock_mode":"","_global_stock_cap":"","_tribe_rsvp_for_event":"","_tribe_ticket_going_count":"","_tribe_ticket_not_going_count":"","_tribe_tickets_list":"[]","_tribe_ticket_has_attendee_info_fields":false,"footnotes":""},"categories":[308,205,22,304,88,330,307,305,334,325,24,93,327,322,206,29,214,44,53,75,301],"tags":[],"class_list":["post-3427","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-agil-scrum","category-beginners","category-coaching","category-comunicacion","category-definition-of-done","category-desarolladores","category-documentacion","category-equipo-distribuidos","category-equipo-scrum","category-historias-de-usuario","category-legacy-code","category-sin-categorizar","category-objetivo-del-sprint","category-practicantes-avanzados","category-practitioners","category-product-owner","category-scrum-artifacts","category-scrum-master","category-simple-design","category-stakeholders","category-transformaciones-agiles"],"yoast_head":"\nHow to manage documents? Should that be a new story? - The Scrum Academy<\/title>\n<meta name=\"description\" content=\"Carlton Nettlton continues his discussion of how traditional functional and technical documentation work in Agile. In this article he explores how to actually build these documents within our Sprints (or iterations)\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to manage documents? Should that be a new story? - The Scrum Academy\" \/>\n<meta property=\"og:description\" content=\"Carlton Nettlton continues his discussion of how traditional functional and technical documentation work in Agile. In this article he explores how to actually build these documents within our Sprints (or iterations)\" \/>\n<meta property=\"og:url\" content=\"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/\" \/>\n<meta property=\"og:site_name\" content=\"The Scrum Academy\" \/>\n<meta property=\"article:published_time\" content=\"2017-08-28T19:00:07+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-17T08:56:09+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/thescrumacademy.com\/wp-content\/uploads\/2017\/08\/pexels-gabby-k-6373293.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"800\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Carlton Nettleton\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"Carlton Nettleton\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tiempo de lectura\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/\"},\"author\":{\"name\":\"Carlton Nettleton\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/#\\\/schema\\\/person\\\/2a0fb199044ecd4af3704c734747fc6a\"},\"headline\":\"How to manage documents? Should that be a new story?\",\"datePublished\":\"2017-08-28T19:00:07+00:00\",\"dateModified\":\"2025-09-17T08:56:09+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/\"},\"wordCount\":359,\"image\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/thescrumacademy.com\\\/wp-content\\\/uploads\\\/2017\\\/08\\\/pexels-gabby-k-6373293.jpg\",\"articleSection\":[\"\u00c1gil Scrum\",\"Beginners\",\"Coaching\",\"Comunicaci\u00f3n\",\"Definition of Done\",\"Desarolladores\",\"Documentaci\u00f3n\",\"Equipo distribuidos\",\"Equipo Scrum\",\"Historias de usuario\",\"Legacy Code\",\"Metodolog\u00eda Scrum\",\"Objetivo del Sprint\",\"Practicantes Avanzados\",\"Practitioners\",\"Product Owner\",\"Scrum Artifacts\",\"Scrum Master\",\"Simple Design\",\"Stakeholders\",\"Transformaciones \u00c1giles\"],\"inLanguage\":\"es\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/\",\"url\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/\",\"name\":\"How to manage documents? Should that be a new story? - The Scrum Academy\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/thescrumacademy.com\\\/wp-content\\\/uploads\\\/2017\\\/08\\\/pexels-gabby-k-6373293.jpg\",\"datePublished\":\"2017-08-28T19:00:07+00:00\",\"dateModified\":\"2025-09-17T08:56:09+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/#\\\/schema\\\/person\\\/2a0fb199044ecd4af3704c734747fc6a\"},\"description\":\"Carlton Nettlton continues his discussion of how traditional functional and technical documentation work in Agile. In this article he explores how to actually build these documents within our Sprints (or iterations)\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#breadcrumb\"},\"inLanguage\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#primaryimage\",\"url\":\"https:\\\/\\\/thescrumacademy.com\\\/wp-content\\\/uploads\\\/2017\\\/08\\\/pexels-gabby-k-6373293.jpg\",\"contentUrl\":\"https:\\\/\\\/thescrumacademy.com\\\/wp-content\\\/uploads\\\/2017\\\/08\\\/pexels-gabby-k-6373293.jpg\",\"width\":1200,\"height\":800},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/2017\\\/08\\\/28\\\/manage-documents-new-story\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to manage documents? Should that be a new story?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/#website\",\"url\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/\",\"name\":\"The Scrum Academy\",\"description\":\"Everyone anywhere can do better Scrum\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/#\\\/schema\\\/person\\\/2a0fb199044ecd4af3704c734747fc6a\",\"name\":\"Carlton Nettleton\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/6d69c37c349230a49a1ec6c77c21c4b35043de9fbcce8a202d61f707025cd537?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/6d69c37c349230a49a1ec6c77c21c4b35043de9fbcce8a202d61f707025cd537?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/6d69c37c349230a49a1ec6c77c21c4b35043de9fbcce8a202d61f707025cd537?s=96&d=mm&r=g\",\"caption\":\"Carlton Nettleton\"},\"description\":\"My name is Carlton Nettleton and I am the President of Look Forward Consulting. I am an international speaker, trainer and author of the book, Fourteen Observations of Good Scrum Practice and my book has been translated into Spanish. My passion is to share my excitement, enthusiasm and encouragement with teams and organizations as they reach for higher levels of performance and engagement. My business is to help your business grow and flourish.\",\"url\":\"https:\\\/\\\/thescrumacademy.com\\\/es\\\/author\\\/admin\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to manage documents? Should that be a new story? - The Scrum Academy","description":"Carlton Nettlton continues his discussion of how traditional functional and technical documentation work in Agile. In this article he explores how to actually build these documents within our Sprints (or iterations)","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/","og_locale":"es_ES","og_type":"article","og_title":"How to manage documents? Should that be a new story? - The Scrum Academy","og_description":"Carlton Nettlton continues his discussion of how traditional functional and technical documentation work in Agile. In this article he explores how to actually build these documents within our Sprints (or iterations)","og_url":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/","og_site_name":"The Scrum Academy","article_published_time":"2017-08-28T19:00:07+00:00","article_modified_time":"2025-09-17T08:56:09+00:00","og_image":[{"width":1200,"height":800,"url":"https:\/\/thescrumacademy.com\/wp-content\/uploads\/2017\/08\/pexels-gabby-k-6373293.jpg","type":"image\/jpeg"}],"author":"Carlton Nettleton","twitter_card":"summary_large_image","twitter_misc":{"Escrito por":"Carlton Nettleton","Tiempo de lectura":"2 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#article","isPartOf":{"@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/"},"author":{"name":"Carlton Nettleton","@id":"https:\/\/thescrumacademy.com\/es\/#\/schema\/person\/2a0fb199044ecd4af3704c734747fc6a"},"headline":"How to manage documents? Should that be a new story?","datePublished":"2017-08-28T19:00:07+00:00","dateModified":"2025-09-17T08:56:09+00:00","mainEntityOfPage":{"@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/"},"wordCount":359,"image":{"@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#primaryimage"},"thumbnailUrl":"https:\/\/thescrumacademy.com\/wp-content\/uploads\/2017\/08\/pexels-gabby-k-6373293.jpg","articleSection":["\u00c1gil Scrum","Beginners","Coaching","Comunicaci\u00f3n","Definition of Done","Desarolladores","Documentaci\u00f3n","Equipo distribuidos","Equipo Scrum","Historias de usuario","Legacy Code","Metodolog\u00eda Scrum","Objetivo del Sprint","Practicantes Avanzados","Practitioners","Product Owner","Scrum Artifacts","Scrum Master","Simple Design","Stakeholders","Transformaciones \u00c1giles"],"inLanguage":"es"},{"@type":"WebPage","@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/","url":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/","name":"How to manage documents? Should that be a new story? - The Scrum Academy","isPartOf":{"@id":"https:\/\/thescrumacademy.com\/es\/#website"},"primaryImageOfPage":{"@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#primaryimage"},"image":{"@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#primaryimage"},"thumbnailUrl":"https:\/\/thescrumacademy.com\/wp-content\/uploads\/2017\/08\/pexels-gabby-k-6373293.jpg","datePublished":"2017-08-28T19:00:07+00:00","dateModified":"2025-09-17T08:56:09+00:00","author":{"@id":"https:\/\/thescrumacademy.com\/es\/#\/schema\/person\/2a0fb199044ecd4af3704c734747fc6a"},"description":"Carlton Nettlton continues his discussion of how traditional functional and technical documentation work in Agile. In this article he explores how to actually build these documents within our Sprints (or iterations)","breadcrumb":{"@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/"]}]},{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#primaryimage","url":"https:\/\/thescrumacademy.com\/wp-content\/uploads\/2017\/08\/pexels-gabby-k-6373293.jpg","contentUrl":"https:\/\/thescrumacademy.com\/wp-content\/uploads\/2017\/08\/pexels-gabby-k-6373293.jpg","width":1200,"height":800},{"@type":"BreadcrumbList","@id":"https:\/\/thescrumacademy.com\/es\/2017\/08\/28\/manage-documents-new-story\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/thescrumacademy.com\/es\/"},{"@type":"ListItem","position":2,"name":"How to manage documents? Should that be a new story?"}]},{"@type":"WebSite","@id":"https:\/\/thescrumacademy.com\/es\/#website","url":"https:\/\/thescrumacademy.com\/es\/","name":"The Scrum Academy","description":"Everyone anywhere can do better Scrum","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/thescrumacademy.com\/es\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es"},{"@type":"Person","@id":"https:\/\/thescrumacademy.com\/es\/#\/schema\/person\/2a0fb199044ecd4af3704c734747fc6a","name":"Carlton Nettleton","image":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/secure.gravatar.com\/avatar\/6d69c37c349230a49a1ec6c77c21c4b35043de9fbcce8a202d61f707025cd537?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/6d69c37c349230a49a1ec6c77c21c4b35043de9fbcce8a202d61f707025cd537?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/6d69c37c349230a49a1ec6c77c21c4b35043de9fbcce8a202d61f707025cd537?s=96&d=mm&r=g","caption":"Carlton Nettleton"},"description":"My name is Carlton Nettleton and I am the President of Look Forward Consulting. I am an international speaker, trainer and author of the book, Fourteen Observations of Good Scrum Practice and my book has been translated into Spanish. My passion is to share my excitement, enthusiasm and encouragement with teams and organizations as they reach for higher levels of performance and engagement. My business is to help your business grow and flourish.","url":"https:\/\/thescrumacademy.com\/es\/author\/admin\/"}]}},"_links":{"self":[{"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/posts\/3427","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/comments?post=3427"}],"version-history":[{"count":0,"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/posts\/3427\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/media\/6491"}],"wp:attachment":[{"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/media?parent=3427"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/categories?post=3427"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/thescrumacademy.com\/es\/wp-json\/wp\/v2\/tags?post=3427"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}