O poder da documentação do código-fonte

Quais os motivos que nos levam a deixar de lado a programação e dedicar um pouco do nosso tempo a comentar nossos códigos?

Até um tempo atrás eu acreditava que não precisava documentar meus projetos, por achá-los bastante legíveis e de fácil interpretação. Em vista disso, não tinha nenhuma necessidade em parar o desenvolvimento e dedicar um tempinho aos comentários.

Por isso estou expondo minha palestra sobre “O poder da documentação do código-fonte”.

Conforme solicitado, segue bibliografia na qual foram baseados os slides

http://codeerror.wordpress.com/2011/03/04/sem-medo-do-javadoc/ – acessado em 5 de maio de 2013
http://www.caloni.com.br/blog/archives/primeiros-passos-na-documentacao-de-codigo-fonte-usando-doxygen – acessado em 5 de maio de 2013
http://www.linhadecodigo.com.br/artigo/1494/aprendendo-a-documentar-o-seu-codigo.aspx – acessado em 5 de maio de 2013
http://www.devmedia.com.br/padronizando-seus-projetos-no-mundo-corporativo-introducao-parte-i/7158 – acessado em 5 de maio de 2013
http://www.michelazzo.com.br/textos/dicas-para-documentacao-de-softwares – acessado em 5 de maio de 2013
http://www.devmedia.com.br/javadoc-implementando-documentacao-atraves-do-netbeans/2495 – acessado em 5 de maio de 2013
http://www.documentacaosistemas.com.br/sistemas/component/content/article/58-a-importancia-de-documentar-sistemas.html – acessado em 10 de maio de 2013

Aguarde, em breve um artigo com maiores explanações.