Desenvolvimento Ágil - Blog da Improve It: Documentação Ágil

Documentação Ágil

Vinicius Manhães Teles — Fri, 01 Aug 2008 21:08:00 -0300

Documentação é assunto que as pessoas vivem me perguntando nas palestras sobre XP. Por exemplo, como fica a documentação em um projeto XP, ou em qualquer metodologia ágil?

O vídeo abaixo é uma tentativa de responder esta questão.

Documentação Ágil from Vinicius Teles on Vimeo.

Link direto para o vídeo.

PS: Amigos com iPhone, não fiquem bravos comigo. Eu sei que vocês preferem que o vídeo esteja no YouTube, para que possam ver no iPhone. Mas, dessa vez ainda não deu. Este vídeo ficou um pouco maior do que eu gostaria, de modo que ultrapassa o limite de upload do YouTube. Uma alternativa é usar o Google Video, que permite vídeos maiores, e você também consegue ver através do cliente YouTube do iPhone. Eu tentei fazer upload para o Google Vídeo, mas ainda não ficou legal. Então, vou continuar tentando obter um resultado satisfatório no Google Video, e assim que alcançar, eu coloco o link aqui no blog. Mas, para adiantar, já estou publicando o vídeo no Vimeo.

"Documentação Ágil" by Jaeder Briseno

Sun, 03 Jan 2010 00:18:10 -0200

Muito boa a palestra! Apesar de já ter ouvido algumas pessoas comentárem que programação ágil não prioriza a documentação... em meus estudos sobre programação xp e em textos relacionados a engenharia de software... percebi que é contrário. E digo mais... que lé atentamente bons livros sobre desenvolvimento percebe muito doque Vinícius falou: documentar o necessário, produzir codigo limpo e auto-descritivo, focar em tornar claro as inter-relações entre os artefatos de software (dependências, impactos e implicações) e as regras de negócio (documentadas) etc. Parabéns.

"Documentação Ágil" by Felipe da Silva

Fri, 18 Dec 2009 13:30:47 -0200

Gostei do vídeo, trata de forma bem realista a verdade por trás da beleza de se documentar.

Parabéns!

"Documentação Ágil" by Roger

Tue, 30 Sep 2008 12:21:04 -0300

Cara, estou precisando baixar o video.. cade o link?? Abraço.

"Documentação Ágil" by Thiago Rodrigues

Mon, 08 Sep 2008 19:15:37 -0300

O vídeo não está mais disponível...

"Documentação Ágil" by Gleibson Dartanham

Fri, 08 Aug 2008 14:40:28 -0300

Olá Vinícius

Estudo XP a um bom tempo. Estou terminando minha graduação, quase sempre trabalhando com XP nos projetos da faculdade desde o inicio. E de lá até hoje sempre escuto essa mesma falácia, que metodologias ágeis são muito fracas em documentação. O que me incomoda é que os próprios alunos, que usam XP, fazem esse tipo de comentário.

Bem lembrado o ponto de mostrar ao cliente que a documentação vai ter um custo e o tempo do projeto vai ser consumido na confecção da documentação. Pouquíssimos clientes levam isso em consideração quando pedem diversos documentos.

No mais, Parabéns pelos comentários Parabéns por ajudar a difundir a idéia de XP (de verdade) na comunidade de desenvolvimento de sofware.

Atenciosamente

"Documentação Ágil" by Danilo Carlos Avante

Tue, 05 Aug 2008 17:12:56 -0300

Olá Vinícius, parabéns pelos videos, realmente o conteúdo disponibilizado dessa forma deixa tudo muito mais claro.

Quanto ao vídeo de documentação gostei muito do que você disse sobre o ato Modelar e o Modelo. Infelizmente algumas pessoas acreditam que modelar se resume ao ato de criar diagramas.

[]'s

"Documentação Ágil" by Vinícius Manhães Teles

Mon, 04 Aug 2008 15:35:06 -0300

Andre, claro, tanto melhor!

"Documentação Ágil" by Andre

Mon, 04 Aug 2008 14:52:06 -0300

Muito bom. Entrando na onda de vídeos e podcasts, será que é possível criar uma documentação "Necessária" em multimídia ao invés criar em papel em um projeto?

"Documentação Ágil" by Roger Leite

Mon, 04 Aug 2008 14:35:21 -0300

Fantástico ! Vou mandar um "spam" com este link no waterfall em que trabalho.

"Documentação Ágil" by Anderson

Mon, 04 Aug 2008 11:02:50 -0300

Vi o ultimo post e realmente ele se enquadra na recomendação. :D Abraços

"Documentação Ágil" by Vinícius Manhães Teles

Mon, 04 Aug 2008 10:41:57 -0300

Olá, Anderson.

Valeu pelas dicas!

Essa questão dos vídeos é bastante nova para mim. Ainda estou tentando entender o ferramental. Portanto, hoje um dos maiores empecilhos para seguir a sua sugestão é minha quase total ignorância de como usar as ferramentas. Com o tempo isso deve mudar e os vídeos poderão melhorar. Em todo caso, veja o último vídeo que foi lançado. Este, de certa forma, está mais enquadrado no que você recomenda.

Grande abraço,

Vinícius

"Documentação Ágil" by Anderson

Mon, 04 Aug 2008 10:22:44 -0300

Essa série de videos da improveit tem sido de grande ajuda não só para mim, mas para todos os que se envolvem com programação ágil. Uma dica que quero dar Vinicius tem a ver com este ultimo post. Como vc colocou no texto, ele ficou muito grande. E fiquei pensando, para que um video? Penso que o video é interessante quando se utiliza de recursos visuais para passar a mensagem proposta. No caso, daria então dois toques para vc. Adiciona conteúdo visual nas apresentações (slides, dados, etc). ou faz podcasts (são mais leves e mais fáceis de produzir). Somente um conteúdo adicional nos videos os tornariam realmente viaveis. :) Bom essa é uma dica somente. Parabéns pelo trabalho.

"Documentação Ágil" by Bruno Miranda

Sat, 02 Aug 2008 13:14:39 -0300

Otimo video.

"Documentação Ágil" by Edson Gonçalves

Sat, 02 Aug 2008 12:43:29 -0300

Excelente vídeo, meus parabéns

"Documentação Ágil" by Diego Carrion

Sat, 02 Aug 2008 00:07:08 -0300

Muito bom o video, arrasou.

"Documentação Ágil" by tapajós

Fri, 01 Aug 2008 21:29:36 -0300

Já estou com raiva por não conseguir ver no iphone.