okfn-brasil / querido-diario-comunidade

Querido Diário - Comunidade e Documentação
https://queridodiario.ok.org.br
MIT License
22 stars 19 forks source link

Atualiza versão em inglês do Contributing #74

Closed jufajardini closed 3 months ago

jufajardini commented 9 months ago

Closes #33

Os documentos em português e em inglês não estavam mais sincronizados.

Observações:

ogecece commented 9 months ago

@jufajardini muito legais essas novas perspectivas que você está trazendo! Concordo totalmente com as modificações sobre referências a contribuição com código. Mas antes de entrar nisso, vou começar respondendo as dúvidas e depois endereçando pontos específicos do PR, beleza?

Fiquei pensando se não seria bom buscar um link de guia pra aprender Git e GH em inglês (ao invés do da Escola de Dados)

Boa! É um tópico que fica fácil de localizar, vamos sim. Pode ser esse da Digital Ocean: https://www.digitalocean.com/community/tutorials/how-to-use-git-effectively

Uma dúvida: existem planos de começar a fazer os commits também em inglês, já que a ideia é meio que deixar o projeto mais acessível internacionalmente?

Não. Era assim até 2021-2022. Optamos por usar o português como idioma padrão em tudo exceto o código desde então.

O que vai ficar sendo traduzido para inglês (e eventualmente espanhol) vão ser as principais documentações. E como esse repositório também tem as issues que compõem o Roadmap, então elas também serão traduzidas.

Mas se alguém inicialmente fizer commit em inglês por enquanto não pedimos pra mudar.

E se alguém quiser se comunicar em inglês ou outro idioma, vamos tentar nos comunicar no idioma que a pessoa escolheu, se possível.

Fiz um commit em separado quebrando as linhas, enquanto pessoa que edita e manté documentação com frequência, tendo a achar melhor para ler e revisar - deixei em commit separado, pois aí posso descartar, e porque fica mais fácil de revisar, também.

Massa!

Como é possível fazer contribuições não relacionadas com código, tomei a liberdade de tentar deixar o guia um pouco mais genérico, ou colocando "code" entre parênteses, ou alterando para "contribuição". Vou destacar no arquivo em si, pra ajudar a visualizar.

Achei ótimo! Pode refletir essas modificações no arquivo em português?

jufajardini commented 9 months ago

@jufajardini muito legais essas novas perspectivas que você está trazendo! Concordo totalmente com as modificações sobre referências a contribuição com código. Mas antes de entrar nisso, vou começar respondendo as dúvidas e depois endereçando pontos específicos do PR, beleza?

Fiquei pensando se não seria bom buscar um link de guia pra aprender Git e GH em inglês (ao invés do da Escola de Dados)

Boa! É um tópico que fica fácil de localizar, vamos sim. Pode ser esse da Digital Ocean: https://www.digitalocean.com/community/tutorials/how-to-use-git-effectively

Uma dúvida: existem planos de começar a fazer os commits também em inglês, já que a ideia é meio que deixar o projeto mais acessível internacionalmente?

Não. Era assim até 2021-2022. Optamos por usar o português como idioma padrão em tudo exceto o código desde então.

O que vai ficar sendo traduzido para inglês (e eventualmente espanhol) vão ser as principais documentações. E como esse repositório também tem as issues que compõem o Roadmap, então elas também serão traduzidas.

Mas se alguém inicialmente fizer commit em inglês por enquanto não pedimos pra mudar.

E se alguém quiser se comunicar em inglês ou outro idioma, vamos tentar nos comunicar no idioma que a pessoa escolheu, se possível.

Fiz um commit em separado quebrando as linhas, enquanto pessoa que edita e manté documentação com frequência, tendo a achar melhor para ler e revisar - deixei em commit separado, pois aí posso descartar, e porque fica mais fácil de revisar, também.

Massa!

Como é possível fazer contribuições não relacionadas com código, tomei a liberdade de tentar deixar o guia um pouco mais genérico, ou colocando "code" entre parênteses, ou alterando para "contribuição". Vou destacar no arquivo em si, pra ajudar a visualizar.

Achei ótimo! Pode refletir essas modificações no arquivo em português?

Gracias pelas respostas, vou incorporar o feedback aqui, e uma vez que as contribuições aqui sejam aceitas, atualizo a versão em português, sim! /o/

jufajardini commented 9 months ago

Vi que temos a #35 para melhorar a versão em português, vou mexer nela também - se as tarefas ainda fizerem sentido :P

Aí não sei bem como fica a questão de qual versão vai ser aceita primeiro. Qualquer coisa, eu volto e atualizo o que ficar desatualizado depois, na versão que for xD