{"id":12178,"date":"2020-12-03T13:42:42","date_gmt":"2020-12-03T19:42:42","guid":{"rendered":"https:\/\/gsb.lat\/documentacao-agil-o-util-e-necessario\/"},"modified":"2023-04-04T09:54:39","modified_gmt":"2023-04-04T15:54:39","slug":"documentacao-agil-o-util-e-necessario","status":"publish","type":"post","link":"https:\/\/gsb.lat\/pt\/documentacao-agil-o-util-e-necessario\/","title":{"rendered":"Documenta\u00e7\u00e3o \u00e1gil: O \u00fatil e necess\u00e1rio"},"content":{"rendered":"\n<ul class=\"wp-block-list\"><li>Documentamos para ajudar <strong><em>os outros e a n\u00f3s pr\u00f3prios<\/em> <\/strong>: Para ensinar aos que n\u00e3o est\u00e3o familiarizados com um sistema como ele \u00e9 estruturado, criado e funciona.  <\/li><li>Para <strong>\n  <em>utilizar, operar, apoiar e manter<\/em>\n<\/strong> o software ao longo do tempo.  <\/li><li>Para <strong>\n  <em>reflectir sobre o produto, <\/em>\n<\/strong>ajudar a solidificar e descobrir aspectos que n\u00e3o foram contemplados.<\/li><li>Para <strong>\n  <em>apoiar a comunica\u00e7\u00e3o com grupos externos e auditorias, como complemento de discuss\u00f5es presenciais, e-mails ou<\/em>\n<\/strong>como complemento de discuss\u00f5es presenciais, e-mails ou ferramentas de colabora\u00e7\u00e3o.  <\/li><li><strong>\n  <em>Liga o design e a codifica\u00e7\u00e3o <\/em>\n<\/strong>para fazer passar a mensagem ou para nos ajudar a n\u00e3o esquecer algo.  <\/li><li><strong>\n  <em>Reduz o custo<\/em>\n<\/strong> de manter o c\u00f3digo legado que \u00e9 dif\u00edcil de compreender e evoluir.<\/li><li>Deve <strong>estar actualizado<\/strong>, <strong>\n  <em>f\u00e1cil de localizar<\/em>\n<\/strong>, <strong>\n  <em>f\u00e1cil de ler e interpretar<\/em>\n<\/strong>.<\/li><li>Documenta\u00e7\u00e3o em Agile \u00e9 um ser vivo <strong>\n  <em>\u00c9 mantida leve e simples.<\/em>\n<\/strong><\/li><li>Est\u00e1 escrito <strong>\n  <em>mesmo a tempo<\/em>\n<\/strong>Quando \u00e9 necess\u00e1rio, quando \u00e9 necess\u00e1rio, antes de aumentar o risco de desatualiza\u00e7\u00e3o e retrabalho.<\/li><li><strong>\n  <em>A documenta\u00e7\u00e3o est\u00e1 inclu\u00edda no processo \u00e1gil, <\/em>\n<\/strong>faz parte do esfor\u00e7o e do custo do produto.<\/li><li>Faz parte do <strong>\n  <em>entrega cont\u00ednua<\/em>\n<\/strong> de software de trabalho.  <\/li><li>Documentar \u00e9 um <strong>\n  <em>processo<\/em>\n<\/strong> <strong>\n  <em>processo de colabora\u00e7\u00e3o<\/em>\n<\/strong> onde cada membro da equipa contribui.  <\/li><li>Tenha um <strong>\n  <em>pessoa de refer\u00eancia que ir\u00e1 gerir o processo de documenta\u00e7\u00e3o<\/em>\n<\/strong>algu\u00e9m que compreende as quest\u00f5es que precisam de ser abordadas e que gere o <strong>\n  <em>controlo de vers\u00f5es<\/em>\n<\/strong>.  <\/li><li>Documentar o que <strong>\n  <em>ajuda a equipa a realizar o seu trabalho<\/em>\n<\/strong> e aquilo que <strong>\n  <em>que acompanha o produto <\/em>\n<\/strong>para utiliza\u00e7\u00e3o e manuten\u00e7\u00e3o. Alguns exemplos:<\/li><li><strong>\n  <em>Trabalho de equipa<\/em>\n<\/strong>Membros da equipa, dados de comunica\u00e7\u00e3o, prefer\u00eancias e particularidades<\/li><li><strong>\n  <em>Acordos de equipa<\/em>\n<\/strong>Defini\u00e7\u00e3o de Pronto (DoR), Defini\u00e7\u00e3o de Feito (DoD), Normas de Documenta\u00e7\u00e3o, entre outros.<\/li><li><strong>\n  <em>Retrospectivas<\/em>\n<\/strong>Resultados da din\u00e2mica e das Ac\u00e7\u00f5es de Melhoria, acompanhamento e an\u00e1lise dos resultados.<\/li><li><strong>\n  <em>Iniciar Doc.<\/em>\n<\/strong>Ficha de produto ou projecto, Prot\u00f3tipos, Mapeamento de hist\u00f3rias de utilizadores, Requisitos de alto n\u00edvel, &#8230;<\/li><li><strong>\n  <em>Documento Funcional do Produto.<\/em>\n<\/strong>: Mapa do processo, Sistema de navega\u00e7\u00e3o, Guias do utilizador, &#8230;<\/li><li><strong>\n  <em>Documenta\u00e7\u00e3o t\u00e9cnica do produto<\/em>\n<\/strong>: Arquitectura do sistema, mapas de dados, servi\u00e7os (APIs), guias de implanta\u00e7\u00e3o, guias de instala\u00e7\u00e3o e opera\u00e7\u00e3o de software.<\/li><\/ul>\n\n<p>Leia mais: <a rel=\"noreferrer noopener\" href=\"https:\/\/masteringbusinessanalysis.com\/mba086-docops-keep-your-documentation-agile\/\" target=\"_blank\">DocOps &#8211; Mantenha a sua documenta\u00e7\u00e3o \u00e1gil<\/a><\/p>\n\n<p class=\"has-text-align-right\">Maria Esther Remedios<\/p>\n\n<p class=\"has-text-align-right\">@soy.agile.coach<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Documentamos para ajudar os outros e a n\u00f3s pr\u00f3prios : Para ensinar aos que n\u00e3o est\u00e3o familiarizados com um sistema como ele \u00e9 estruturado, criado e funciona. Para utilizar, operar, apoiar e manter o software ao longo do tempo. Para reflectir sobre o produto, ajudar a solidificar e descobrir aspectos que n\u00e3o foram contemplados. Para&hellip;<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[547],"tags":[558],"class_list":["post-12178","post","type-post","status-publish","format-standard","hentry","category-blog-pt","tag-mexico-pt","category-547","description-off"],"_links":{"self":[{"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/posts\/12178","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/comments?post=12178"}],"version-history":[{"count":1,"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/posts\/12178\/revisions"}],"predecessor-version":[{"id":12184,"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/posts\/12178\/revisions\/12184"}],"wp:attachment":[{"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/media?parent=12178"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/categories?post=12178"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gsb.lat\/pt\/wp-json\/wp\/v2\/tags?post=12178"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}