<div>Documentar se aprende na marra</div><div> </div><div>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ê.</div>

<div> </div><div>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.</div>

<div> </div><div>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.</div><div> </div><div>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.</div>

<div> </div><div>Continuo fazendo isso? não, essa foi minha única experiência com pacotes.</div><div><br clear="all">lmassis <at> yahoo <dot> com <dot> br<br>assis.leonard <at> gmail <dot> com<br>


<br><br></div><div class="gmail_quote">2011/8/11 Leandro Marino <span dir="ltr"><<a href="mailto:leandromarino@leandromarino.com.br">leandromarino@leandromarino.com.br</a>></span><br><blockquote style="margin: 0px 0px 0px 0.8ex; padding-left: 1ex; border-left-color: rgb(204, 204, 204); border-left-width: 1px; border-left-style: solid;" class="gmail_quote">

<font color="#333333"><font size="2"><font face="trebuchet ms,sans-serif"><i>Gosto da possibilidade de pacotes, apesar de ainda não ter feito nenhum. nos meus primeiros testes todos estao totalmente NÃO documentados...<br>



<br>Enfim... Como são funções quase auto-explicativas (só eu e o Prof. Ruben entendemos) =P <br><br>O problema é que ainda temos que generalizar muitas delas... <br><br clear="all"></i></font></font></font>Atenciosamente,<br>



Leandro Marino<br><a href="http://www.leandromarino.com.br" target="_blank">http://www.leandromarino.com.br</a> (Fotógrafo)<br><a href="http://est.leandromarino.com.br/Blog" target="_blank">http://est.leandromarino.com.br/Blog</a> (Estatístico)<br>

Cel.: <a href="tel:%2B%2055%2021%209845-7707" target="_blank" value="+552198457707">+ 55 21 9845-7707</a><br>

Cel.: <a href="tel:%2B%2055%2021%208777-7907" target="_blank" value="+552187777907">+ 55 21 8777-7907</a><br><br>
<br><br><div class="gmail_quote">Em 11 de agosto de 2011 21:05, Jose Claudio Faria <span dir="ltr"><<a href="mailto:joseclaudio.faria@gmail.com" target="_blank">joseclaudio.faria@gmail.com</a>></span> escreveu:<div>

<div></div><div class="h5"><br><blockquote style="margin: 0px 0px 0px 0.8ex; padding-left: 1ex; border-left-color: rgb(204, 204, 204); border-left-width: 1px; border-left-style: solid;" class="gmail_quote">

Eu venho cedendo a essa tentação a tantos anos... ;)<br>
(Mas minhas funções de uso pessoal são bem documentadas)<br>
<div><br>
Abs,<br>
--<br>
///\\\///\\\///\\\///\\\///\\\///\\\///\\\///\\\<br>
Jose Claudio Faria<br>
Estatistica - Prof. Pleno<br>
UESC/DCET/Brasil<br>
joseclaudio.faria at <a href="http://gmail.com" target="_blank">gmail.com</a><br>
///\\\///\\\///\\\///\\\///\\\///\\\///\\\///\\\<br>
<br>
</div>Em 11 de agosto de 2011 20:17, Benilton Carvalho<br>
<<a href="mailto:beniltoncarvalho@gmail.com" target="_blank">beniltoncarvalho@gmail.com</a>> escreveu:<br>
<div><div></div><div>> Exatamente, Leonard, esse e' o modo que eu considero "correto" para<br>
> gerenciar coisas assim.<br>
><br>
> Mas ha' vezes nas quais cedemos `a tentacao... :-)<br>
> _______________________________________________<br>
> R-br mailing list<br>
> <a href="mailto:R-br@listas.c3sl.ufpr.br" target="_blank">R-br@listas.c3sl.ufpr.br</a><br>
> <a href="https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br" target="_blank">https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br</a><br>
> Leia o guia de postagem (<a href="http://www.leg.ufpr.br/r-br-guia" target="_blank">http://www.leg.ufpr.br/r-br-guia</a>) e forneça código mínimo reproduzível.<br>
><br>
_______________________________________________<br>
R-br mailing list<br>
<a href="mailto:R-br@listas.c3sl.ufpr.br" target="_blank">R-br@listas.c3sl.ufpr.br</a><br>
<a href="https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br" target="_blank">https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br</a><br>
Leia o guia de postagem (<a href="http://www.leg.ufpr.br/r-br-guia" target="_blank">http://www.leg.ufpr.br/r-br-guia</a>) e forneça código mínimo reproduzível.<br>
</div></div></blockquote></div></div></div><br>
<br>_______________________________________________<br>
R-br mailing list<br>
<a href="mailto:R-br@listas.c3sl.ufpr.br">R-br@listas.c3sl.ufpr.br</a><br>
<a href="https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br" target="_blank">https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br</a><br>
Leia o guia de postagem (<a href="http://www.leg.ufpr.br/r-br-guia" target="_blank">http://www.leg.ufpr.br/r-br-guia</a>) e forneça código mínimo reproduzível.<br></blockquote></div><br>