{"id":19482,"date":"2019-07-22T14:13:36","date_gmt":"2019-07-22T12:13:36","guid":{"rendered":"https:\/\/www.mtp.es\/?p=19482"},"modified":"2019-07-22T14:13:36","modified_gmt":"2019-07-22T12:13:36","slug":"documentar-importante-pero-medida-justa-y-necesaria","status":"publish","type":"post","link":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/","title":{"rendered":"Documentar es importante, pero en la medida justa y necesaria"},"content":{"rendered":"<p>Hace unas semanas trat\u00e1bamos en el blog la importancia del <a href=\"https:\/\/mtp.global\/es\/blog\/testing-software\/el-equipo-tecnico-fundamental-para-trabajar-bajo-metodologias-agiles\/\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>equipo t\u00e9cnico<\/strong><\/a> como uno de los pilares en los que se basa el trabajo con <strong>metodolog\u00edas \u2018agiles\u2019<\/strong>. Desde MTP, empresa en la que nos dedicamos a todo lo relacionado con el aseguramiento del negocio digital (Digital Business Assurance), y en la que el \u00e1rea de <a href=\"https:\/\/mtp.global\/es\/testing-software\/\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>DevOps &amp; Agile<\/strong><\/a> tiene gran importancia, vamos a continuar hablando de los \u2018principios \u00e1giles\u2019 y de nuestra experiencia en este campo.<\/p>\n<p>Uno de los <strong>valores de las metodolog\u00edas \u00e1giles<\/strong> que genera m\u00e1s controversia o dificultades a la hora de aplicar es aquel que dice: \u201cSoftware funcionando por encima de <strong>documentaci\u00f3n<\/strong> exhaustiva\u201d.<\/p>\n<p>Se ha pasado de una forma de trabajar en la que se generaban kil\u00f3metros y kil\u00f3metros de documentaci\u00f3n -en la que de toda reuni\u00f3n se realizaba un acta, en la que de cualquier modificaci\u00f3n o cambio se escrib\u00eda un documento, no para aportar un valor final al producto si no para generar una falsa seguridad o protecci\u00f3n sobre el trabajo- a, en muchos casos, no generar nada de documentaci\u00f3n, no dejar por escrito aquellas cosas importantes que permita trabajar con m\u00e1s facilidad sobre el producto. Esto hace que siga habiendo un <strong>problema<\/strong>, pero simplemente del signo contrario al anterior.<\/p>\n<p>Un <strong>exceso de documentaci\u00f3n<\/strong> genera un desperdicio, una p\u00e9rdida de tiempo, y en la mayor\u00eda de las veces no est\u00e1 aportando un valor al producto. Una <strong>falta de documentaci\u00f3n<\/strong> total genera un re-trabajo, una p\u00e9rdida de tiempo y en muchas ocasiones, hace dependiente el producto de aquellas personas que trabajan en \u00e9l, pues son los contenedores de la informaci\u00f3n.<\/p>\n<p>Este valor indica, que lo m\u00e1s importante es que al final de cada <em>sprint<\/em>, lo realizado se encuentre funcionando, que de un <strong>valor real al producto en el que se trabaja<\/strong>, y que el <em>software<\/em> sea intuitivo y funcional, pero no indica nada de que no se deba documentar.<\/p>\n<p>Documentar es importante, <strong>en la documentaci\u00f3n se encuentra el conocimiento de ese producto<\/strong>, el por qu\u00e9 se ha escogido ese dise\u00f1o, c\u00f3mo se estructura<strong>\u2026\u00a0 el valor de las metodolog\u00edas agiles no es excluyente<\/strong>. El <em>software<\/em> debe estar funcionando y no debe haber una documentaci\u00f3n exhaustiva.<\/p>\n<h2>LA DOCUMENTACI\u00d3N, LA IMPRESCINDIBLE, QUE APORTE VALOR<\/h2>\n<p><strong>La documentaci\u00f3n que se debe generar debe ser la necesaria, la realmente valiosa, la imprescindible<\/strong>. No son necesarios ya esos documentos extensos y s\u00faper detallados\u00a0 que requieren de un mantenimiento constante cada vez que el producto sufre una ligera modificaci\u00f3n, restando tiempo de trabajo en lo que realmente importa, un <em>software <\/em>funcionando.<\/p>\n<p>Una buena forma a la hora de documentar con la idea de <strong>aumentar la eficacia y eficiencia de nuestro trabajo<\/strong>, de ser \u00e1gil, es preguntarse cada vez que realizo un documento:\u00a0 \u00bfTiene que ser tan extenso? A qui\u00e9n va dirigido, \u00bfle aporta algo de verdad?\u00a0 \u00bfEs totalmente necesario? \u00bfVa a limitar las interacciones personales? Si la respuesta a estas preguntas es NO, es mejor no documentar. Si es SI, documenta.<\/p>\n<p>&nbsp;<\/p>\n<p><strong>Jaime Ursul Turleque<\/strong><\/p>\n<p><strong>MTP <\/strong><strong>&#8211; Scrum Master y Product Owner<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Hace unas semanas trat\u00e1bamos en el blog la importancia del equipo t\u00e9cnico como uno de los pilares en los que se basa el trabajo con metodolog\u00edas \u2018agiles\u2019. Desde MTP, empresa en la que nos dedicamos a todo lo relacionado con el aseguramiento del negocio digital (Digital Business Assurance), y en la que el \u00e1rea de [&hellip;]<\/p>\n","protected":false},"author":9,"featured_media":19484,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[204],"tags":[150],"class_list":["post-19482","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-archivo","tag-desarrollo-de-software"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.1.1 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Documentar: solo lo justo y necesario | MTP<\/title>\n<meta name=\"description\" content=\"Documentar es importante, pero en la medida justa y necesaria. El material que se genere debe ser el necesario, el realmente valioso, el imprescindible.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Documentar: solo lo justo y necesario | MTP\" \/>\n<meta property=\"og:description\" content=\"Documentar es importante, pero en la medida justa y necesaria. El material que se genere debe ser el necesario, el realmente valioso, el imprescindible.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/\" \/>\n<meta property=\"og:site_name\" content=\"MTP Espa\u00f1a\" \/>\n<meta property=\"article:published_time\" content=\"2019-07-22T12:13:36+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1100\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"MTP\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"MTP\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tiempo de lectura\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutos\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Documentar: solo lo justo y necesario | MTP","description":"Documentar es importante, pero en la medida justa y necesaria. El material que se genere debe ser el necesario, el realmente valioso, el imprescindible.","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:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/","og_locale":"es_ES","og_type":"article","og_title":"Documentar: solo lo justo y necesario | MTP","og_description":"Documentar es importante, pero en la medida justa y necesaria. El material que se genere debe ser el necesario, el realmente valioso, el imprescindible.","og_url":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/","og_site_name":"MTP Espa\u00f1a","article_published_time":"2019-07-22T12:13:36+00:00","og_image":[{"width":1920,"height":1100,"url":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg","type":"image\/jpeg"}],"author":"MTP","twitter_card":"summary_large_image","twitter_misc":{"Escrito por":"MTP","Tiempo de lectura":"3 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#article","isPartOf":{"@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/"},"author":{"name":"MTP","@id":"https:\/\/mtp.global\/es\/#\/schema\/person\/1186350db6f59e8360dd481150654813"},"headline":"Documentar es importante, pero en la medida justa y necesaria","datePublished":"2019-07-22T12:13:36+00:00","mainEntityOfPage":{"@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/"},"wordCount":540,"publisher":{"@id":"https:\/\/mtp.global\/es\/#organization"},"image":{"@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#primaryimage"},"thumbnailUrl":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg","keywords":["desarrollo de software"],"articleSection":["Archivo"],"inLanguage":"es"},{"@type":"WebPage","@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/","url":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/","name":"Documentar: solo lo justo y necesario | MTP","isPartOf":{"@id":"https:\/\/mtp.global\/es\/#website"},"primaryImageOfPage":{"@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#primaryimage"},"image":{"@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#primaryimage"},"thumbnailUrl":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg","datePublished":"2019-07-22T12:13:36+00:00","description":"Documentar es importante, pero en la medida justa y necesaria. El material que se genere debe ser el necesario, el realmente valioso, el imprescindible.","breadcrumb":{"@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/"]}]},{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#primaryimage","url":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg","contentUrl":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg","width":1920,"height":1100,"caption":"Metodolog\u00edas 'agile' MTP"},{"@type":"BreadcrumbList","@id":"https:\/\/mtp.global\/es\/blog\/archivo\/documentar-importante-pero-medida-justa-y-necesaria\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/mtp.global\/es\/home\/"},{"@type":"ListItem","position":2,"name":"Documentar es importante, pero en la medida justa y necesaria"}]},{"@type":"WebSite","@id":"https:\/\/mtp.global\/es\/#website","url":"https:\/\/mtp.global\/es\/","name":"MTP Global","description":"","publisher":{"@id":"https:\/\/mtp.global\/es\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/mtp.global\/es\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es"},{"@type":"Organization","@id":"https:\/\/mtp.global\/es\/#organization","name":"MTP Global","url":"https:\/\/mtp.global\/es\/","logo":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/mtp.global\/es\/#\/schema\/logo\/image\/","url":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2024\/07\/MTP-global.png","contentUrl":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2024\/07\/MTP-global.png","width":1200,"height":400,"caption":"MTP Global"},"image":{"@id":"https:\/\/mtp.global\/es\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/mtp.global\/es\/#\/schema\/person\/1186350db6f59e8360dd481150654813","name":"MTP","image":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/mtp.global\/es\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/9f80fcebb065607a1066a38846083841707346cf76ca0c1df24aea7a0c5d4047?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/9f80fcebb065607a1066a38846083841707346cf76ca0c1df24aea7a0c5d4047?s=96&d=mm&r=g","caption":"MTP"},"url":"https:\/\/mtp.global\/es\/blog\/author\/marketing\/"}]}},"fimg_url":"https:\/\/mtp.global\/es\/wp-content\/uploads\/2019\/07\/mtp_agile.jpg","_links":{"self":[{"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/posts\/19482","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/users\/9"}],"replies":[{"embeddable":true,"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/comments?post=19482"}],"version-history":[{"count":0,"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/posts\/19482\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/media\/19484"}],"wp:attachment":[{"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/media?parent=19482"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/categories?post=19482"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mtp.global\/es\/wp-json\/wp\/v2\/tags?post=19482"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}