Blog da Improve It

Documentação Ágil

Publicado por Vinicius Manhães Teles há 4 meses.

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.

Tags , , , , , , , , , , ,  | 14 comentários

O que você achou? Coloque seus comentários e sugestões abaixo!

Acompanhe o RSS dessa página.

Comentários (14 até o momento)

  1. tapajós disse 22 minutos depois:

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

  2. Diego Carrion disse aproximadamente 3 horas depois:

    Muito bom o video, arrasou.

  3. Edson Gonçalves disse aproximadamente 16 horas depois:

    Excelente vídeo, meus parabéns

  4. Bruno Miranda disse aproximadamente 16 horas depois:

    Otimo video.

  5. Anderson disse 3 dias depois:

    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.

  6. Vinícius Manhães Teles disse 3 dias depois:

    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

  7. Anderson disse 3 dias depois:

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

  8. Roger Leite disse 3 dias depois:

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

  9. Andre disse 3 dias depois:

    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?

  10. Vinícius Manhães Teles disse 3 dias depois:

    Andre, claro, tanto melhor!

  11. Danilo Carlos Avante disse 4 dias depois:

    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

  12. Gleibson Dartanham disse 7 dias depois:

    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

  13. Thiago Rodrigues disse aproximadamente 1 mês depois:

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

  14. Roger disse aproximadamente 1 mês depois:

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