Atualiza versão em inglês do Contributing #74
Conversation
jufajardini
force-pushed
the
33-update-contributing-EN/v1
branch
from
e124662 to
aa2c96a
Compare
jufajardini
force-pushed
the
33-update-contributing-EN/v1
branch
from
aa2c96a to
bdb5bb3
Compare
|
@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?
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
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.
Massa!
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
force-pushed
the
33-update-contributing-EN/v1
branch
from
bdb5bb3 to
651910b
Compare
.github/CONTRIBUTING-en-US.md
Outdated
| - During the reviewing process, a reviewer can open *threads* requesting improvements to | ||
| your contribution. In general, it is the reviewers' role to decide when a *thread* has ended. |
There was a problem hiding this comment.
Esta linha aqui é relativa a marcar as discussões na interface do GH como resolvidas/resolved? Eu tinha achado que era algo mais abstrato, quando estava traduzindo, porque não estou acostumada com esse uso, mas fui pescar em outro PR como era o processo de incorporar feedback de vocês, e aí caiu a ficha que provavelmente era a isso que se referia...
Se for, será que faria sentido colocar uma imagem pra ajudar a visualizar? Ou é algo mais universal, que as pessoas aprendem com tutoriais de git?
There was a problem hiding this comment.
É exatamente isso mesmo :)
Prefiriria que a gente colocasse imagem de interface (que não temos controle) em último caso para não termos problemas com estilos mudando ou diferenças entre dispositivos.
Mas não, não é algo que se aprende nos tutoriais de git normalmente. Deixar o texto mais explícito funcionaria pra você? Algo como:
During the reviewing process, a reviewer can open threads requesting improvements to your contribution. In general, it is the reviewers' role to decide when a thread has ended and mark it as "resolved" in the interface. That will mean that both of you agree with the implemented modifications and the contribution can move on.
There was a problem hiding this comment.
É exatamente isso mesmo :)
Prefiriria que a gente colocasse imagem de interface (que não temos controle) em último caso para não termos problemas com estilos mudando ou diferenças entre dispositivos.
Beleza! Fatos, por vezes eu me passo nessas paradas...
Mas não, não é algo que se aprende nos tutoriais de git normalmente. Deixar o texto mais explícito funcionaria pra você? Algo como:
During the reviewing process, a reviewer can open threads requesting improvements to your contribution. In general, it is the reviewers' role to decide when a thread has ended and mark it as "resolved" in the interface. That will mean that both of you agree with the implemented modifications and the contribution can move on.
Acho que fica melhor! Vou incorporar, acho que só vou acrescentar um "git hub" no interface :P
jufajardini
changed the title
jufajardini
force-pushed
the
33-update-contributing-EN/v1
branch
2 times, most recently
from
482c9a4 to
c2fa0b9
Compare
|
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 |
jufajardini
force-pushed
the
33-update-contributing-EN/v1
branch
from
c2fa0b9 to
582d7f7
Compare
There was a problem hiding this comment.
@jufajardini desculpa a demora. O PR acabou demorando pra ser aprovado.
Agradeço demais a paciência!
Os documentos em português e em inglês não estavam mais sincronizados.
Para facilitar leitura e edição, quebra as linhas em por volta de 90 caracteres.
ogecece
force-pushed
the
33-update-contributing-EN/v1
branch
from
582d7f7 to
888bee5
Compare
Resolve: #35 Havia duas indicações de coisas para fazer: - listar repo de backend - já estava - adicionar parágrafo sobre PRs ou issues abandonadas - acrescentei, na seção de interação com as pessoas revisoras - aproveitei e também formatei o arquivo quebrando linhas em torno de 90 caracteres. Acho que esta tarefa terá mais uma coisa pra ser feita nela, quando #74 for aceito, já que me pediram pra incorporar umas mudanças introduzidas lá nessa versão em português.
Closes #33
Os documentos em português e em inglês não estavam mais sincronizados.
Observações: