[Gastosabertos-dev] Documentação, commits e IRC

Quarta Janeiro 21 18:17:56 UTC 2015

Oi, Tom! Acho excelente que você acompanhe o desenvolvimento! Vai nos ajudar
bastante a ter noção de como está a replicabilidade do sistema.

Tenho uma questão, será que é bom mesmo a documentação ficar em inglês?
O código e commits acho que ok, mas até a doc? Será que isso não pode ser mais
uma barreira para alguém que queria aprender algo com o projeto, ou
replicá-lo? (assumindo que essa pessoa provavelmente será brasileira) Eu sei
que entre nós temos a impressão que todo mundo sabe inglês, ainda mais se
mexer com computação, mas tenho minhas dúvidas se isso realmente é verdade...

Por outro lado, usando inglês na doc facilitamos que estrangeiros também se
apropriem do projeto...

E agora?

Outra coisa, o Edgar comentou do nosso canal do IRC não ser "logado", não ter
um registro das conversas. Achei um logger que parece ok:
https://github.com/whitequark/irclogger
Promete ficar com essa cara:
http://irclog.whitequark.org/ruby
Acham que compensa instalar? No DigitalOcean? Só que ele usa NginX,
provavelmente por conta dos WebSockets... Se quiserem posso tentar instalar.

Abs

Quoting Everton Zanella Alvarenga (2015-01-21 15:15:04)
> Já que o Lucas tocou no assunto, acho importante pensarmos no projeto de modo
> que ele possa caminhar na eventual ausência de seus executores, por isso a
> importância da sua documentação.
> 
> Vou tentar acompanhar de perto o desenvolvimento, por isso vou ter na minha
> máquina uma instância sempre atualizada dos código em desenvolvimento.
> 
> Comecei colocando no README.md as etapas para deixar o Flask no ar. Posso ir
> fazendo coisas desse tipo, enquanto vocês focam em codar, mas toda ajuda será
> bem-vinda! (estou vendo a sintaxe dessa linguagem de marcação ainda)
> 
> O Lucas passou no IRC agora um guia legal para os textos dos commits. Seria
> legal estarmos sempre lá (#gastosabertos @ Freenode.net - copiando o e-mail do
> time, caso alguém queira ficar por lá também ; )
> 
> E vamos manter tudo em inglês no código, commits e documentações, salvo
> tutoriais aqui para o Brasil. :)
> 
> Até!
> 
> Tom
> 
> Em 21 de janeiro de 2015 08:21, Lucas Pirola <lucaspirola em gmail.com> escreveu:
> 
>     o ambiente de desenvolvimento é essencial que esteja bem documentado para
>     que outros programadores não percam tempo com esse trabalho.
> 
>  
> --
> Everton Zanella Alvarenga (also Tom)
> Open Knowledge Brasil - Rede pelo Conhecimento Livre
> http://br.okfn.org