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

Quarta Janeiro 21 18:36:25 UTC 2015

Oi Lucas,

a idéia é que o projeto seja reaproveitado por outros desenvolvedores
de qualquer lugar do mundo, pelo menos as visualizações que deverão ser
pensadas como programas independentes. Em português isso seria uma 
limitação
muito grande. E convenhamos, se for desenvolvedor no Brasil (ou 
qualquer
lugar no mundo) tem que saber inglês.

abs
Edgar

On 21/01/2015 16:30, Lucas Pirola wrote:
> 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 
> [7]>
> 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 [1]
>> Promete ficar com essa cara:
>> http://irclog.whitequark.org/ruby [2]
>> 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 [3]> 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 [4]
>> _______________________________________________
>> Gastosabertos-dev mailing list
>> Gastosabertos-dev em lists.okfn.org [5]
>> https://lists.okfn.org/mailman/listinfo/gastosabertos-dev [6]
>
>
> Links:
> ------
> [1] https://github.com/whitequark/irclogger
> [2] http://irclog.whitequark.org/ruby
> [3] mailto:lucaspirola em gmail.com
> [4] http://br.okfn.org
> [5] mailto:Gastosabertos-dev em lists.okfn.org
> [6] https://lists.okfn.org/mailman/listinfo/gastosabertos-dev
> [7] mailto:andres em inventati.org