Redatores Técnicos

Redatores técnicos ajudam a equipe a criar e manter a documentação do projeto. Um dos desafios de um projeto XP é o ritmo semanal de desenvolvimento. Se a equipe tiver que manter documentos extensos e muito elaborados, ela dificilmente será capaz de entregar um conjunto significativo de novas funcionalidades a cada iteração. Além disso, equipes XP acolhem mudanças como algo natural no processo de desenvolvimento, o que afeta a documentação e pode fazer com que ela tenha de ser alterada freqüentemente.

Redatores técnicos asseguram que a documentação evolua de forma iterativa. Ao invés de investirem em documentar o projeto, extensivamente, desde o início de cada iteração, redatores técnicos atualizam os documentos mais perto do fim das iterações. Dessa forma, eles descrevem o que foi feito de fato pelos desenvolvedores, ao invés daquilo que eles combinaram que iriam fazer. Isso tende a gerar menos mudanças.

Publicações técnicas provêm feedback sobre o desenvolvimento para pessoas que não estão suficientemente próximas para acompanharem o dia-a-dia da equipe. Os redatores técnicos devem compreender quem é o público alvo das publicações, assegurar que a linguagem certa seja usada e fazer com que a informação seja atualizada continuamente. Por outro lado, devem monitorar o uso dos documentos e, na medida do possível, eliminar documentos que não estejam provendo valor para o projeto.

Autoria

Texto de Vinícius Manhães Teles.
Ilustrações de Leandro Mello.

Publicado em 02/10/2006.

Licenciado como Creative Commons Atribuição.