vuejs-br / docs-next

Documentação do Vue 3 traduzida para Português Brasileiro (WIP).
https://vuejsbr-docs-next.netlify.app
MIT License
99 stars 63 forks source link

Conferir e adequar tradução de acordo com reformulação #290

Open viniciusdeliz opened 2 years ago

viniciusdeliz commented 2 years ago

Aparentemente houveram consideráveis mudanças na documentação, tanto em conteúdo e estrutura como inclusive agora adotando o VitePress, por exemplo. Não cheguei a conferir tudo, mas temo que o trabalho anterior seja descartado.

Guia de como realizar a tradução da documentação atual: https://github.com/vuejs-translations/guidelines/blob/main/README.md Repositório oficial de traduções: https://github.com/vuejs-translations

Alguma sugestão do que deve ser feito para incluirmos a versão em português da documentação oficial do vue?

viniciusdeliz commented 2 years ago

Dei uma conferida no repositório oficial da documentação, https://github.com/vuejs/docs, e apesar de a estrutura dos arquivos e configurações estar consideravelmente diferente, aparentemente uma boa parte do conteúdo pode ser aproveitada. É necessário um "trabalho de formiguinha" imagino entretanto para que seja feita a conferência dos arquivos e/ou trechos que podem ser migrados para a estrutura mais atualizada.

viniciusdeliz commented 2 years ago

@GuiDevloper tudo bem começar a realizar a migração ou ela já estaria em progresso no momento?

viniciusdeliz commented 2 years ago

Menciono @ErickPetru aqui também pois qualquer atualização, status ou recomendação sobre isso seria ótimo.

ErickPetru commented 1 year ago

@viniciusdeliz, agradeço sua proatividade em investigar este assunto, e suas conclusões estão corretas: A documentação oficial mudou muito em estrutura com a migração para VitePress. Embora muito conteúdo tenha permanecido, há ainda mais conteúdo modificado (principalmente por causa da adição dos exemplos em Composition API que não existiam na documentação anteriormente). Certamente, será um "trabalho de formiguinha", comparando arquivo por arquivo, puxando e reaproveitando trechos de tradução que ainda fazem sentido, e refazendo o que não fizer. Infelizmente não poderei me envolver neste trabalho desta vez, por total falta de disponibilidade, mas caso precisem de alguma instrução em especial pode citar aqui na pergunta.

viniciusdeliz commented 1 year ago

Aparentemente a tradução oficial agora, linkada no repositório oficial das traduções do Vue, é a seguinte: https://github.com/vuejs-translations/guidelines/discussions/26 -> https://github.com/nazarepiedady/vue3-docs-pt

ErickPetru commented 1 year ago

@viniciusdeliz, nenhuma tradução é oficial enquanto não é listada aqui: https://vuejs.org/translations/. Esta que você citou, aliás, sequer foi reconhecida pelo core team como um trabalho em progresso oficial, como pode-se observar ali.

Dito isso, sou pessoalmente muito a favor de esforços coletivos como comunidade e que todos os falantes de português se ajudem. Nazaré é um angolano muito ativo em materiais em português, já tive a oportunidade de interagir com ele várias vezes. Recomendo que qualquer esforço na tradução da nova documentação Vue 3 seja realizada em conjunto, se possível.

Me avisem quando estivermos acima de 90% concluído, assim posso falar para o core team oficializar a tradução.

viniciusdeliz commented 1 year ago

@viniciusdeliz, nenhuma tradução é oficial enquanto não é listada aqui: https://vuejs.org/translations/. Esta que você citou, aliás, sequer foi reconhecida pelo core team como um trabalho em progresso oficial, como pode-se observar ali.

Dito isso, sou pessoalmente muito a favor de esforços coletivos como comunidade e que todos os falantes de português se ajudem. Nazaré é um angolano muito ativo em materiais em português, já tive a oportunidade de interagir com ele várias vezes. Recomendo que qualquer esforço na tradução da nova documentação Vue 3 seja realizada em conjunto, se possível.

Me avisem quando estivermos acima de 90% concluído, assim posso falar para o core team oficializar a tradução.

@ErickPetru, agradeço pelo texto, atenção e esclarecimento dedicados à pauta. De fato não está mencionada a tradução no deploy oficial da documentação. Entretanto, no repositório oficial de traduções, como tentei elucidar na mensagem anterior, o repositório de tradução em português mencionado está flagrado como tradução ativa em progresso:

Registro da adição da traducão em andamento em Português pelo core-team member Jinjiang: https://github.com/vuejs-translations/guidelines/commit/278cd9b19a5051ea64cda62f8fc098111bd43d30

Imagem do estado atual do repositório oficial de traduções do Vue: vue-pt-progress