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

Quarta Janeiro 21 18:30:27 UTC 2015

Deveríamos levar em consideração o público alvo que irá acessar o
código-fonte e irá querer contribuir. Como os gastos são referentes ao
Brasil, fico na dúvida se inglês deve ser o idioma da documentação e do
commit.

Até!

On Wed Jan 21 2015 at 4:18:05 PM Andres MRM <andres em inventati.org> wrote:

>
> 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
> _______________________________________________
> Gastosabertos-dev mailing list
> Gastosabertos-dev em lists.okfn.org
> https://lists.okfn.org/mailman/listinfo/gastosabertos-dev
>
-------------- Próxima Parte ----------
Um anexo em HTML foi limpo...
URL: <http://lists.okfn.org/pipermail/gastosabertos-dev/attachments/20150121/669be419/attachment-0003.html>