Documentar se aprende na marra
De 2006 ao início de 2008, trabalhei em uma empresa em que alem de comentar o código, tinhamos que escrever wikipages de cada coisa que fazíamos. Tudo também era submetido a um controle de versão, cada commit tinha que ter um porquê.
No início foi muito tedioso, via de regra caíamos na tentação de comentar e documentar cada "if' que existia, mas com o tempo fomos aprendendo o que comentar, o que documentar e como fazer isso.
No ínício, as rotinas no R eram .R cheias de comentários, a gente simplesmente baixava do svn e rodava, os resultados e datasets eram comitados em outra pasta, muita burocracia.
Durante uma semana em que estava mudando de emprego, iniciei a aventura de escrever pacote, foi um parto, .mas descobri alguns erros preocupantes em algumas funções, os quais informei para a empresa que eu estava anteriormente. Estes erros só foram descobertos devido ao jeito como a gente documentava as coisas.
Continuo fazendo isso? não, essa foi minha única experiência com pacotes.
lmassis <at> yahoo <dot> com <dot> br
assis.leonard <at> gmail <dot> com