Discussão para uma proposta de…

Discussão para uma proposta de tradução da documentação do WordPress para pt_BR

Estou trazendo para cá alguns pontos discutidos no Slack da comunidade brasileira.

Hoje a documentação do WordPress no pt_BR é incompleta e, em alguns casos, obsoleta. Para piorar, não há uma rotina de atualização, nem um esforço em tentar deixar ela em dia.

Sabendo da importância da documentação para nossos usuários brasileiros, sugeri de tentarmos colocar ordem nessa questão. Por isso, vou organizar aqui neste tópico o estado das coisas para avaliarmos os próximos passos.

O que existe hoje

Atualmente o site oficial da documentação do WordPress é https://wordpress.org/documentation/
Sua versão brasileira ainda é o site antigo quando se chamava “Suporte”: https://br.wordpress.org/support/

Conversando com o @foosantos, ele me passou que houve uma tentativa de estruturar algo em 2020. Esta página explica um pouco do que foi decidido: https://br.wordpress.org/team/handbook/documentacao/

Também há um canal no Slack dedicado para documentação, #documentacao.

Os desafios

Nas palavras do @foosantos: “Acredito que a dificuldade seja sempre de atualizar tudo (considerando a forma que funciona atualmente). Tudo acaba ficando desatualizado em pouco tempo e não é fácil atualizar.”

Não tem uma forma fácil de saber que os posts originais foram atualizados, então mesmo que a gente tenha todas as páginas 100% traduzidas agora, elas ficarão obsoletas em pouco tempo.

Um cenário ideal, de acordo com o @foosantos, seria se houvesse alguma forma de notificação quando algum post da documentação fosse atualizado internacionalmente. Mas isso envolveria modificações por parte da equipe de documentação.

Discussão internacional

Essa questão é complexa não só para nossa localidadeLocalidade Uma localidade (em oposição a “local”) é a combinação de um idioma e um dialeto regional. Os locais geralmente se referem a países. Por exemplo, Português (Portugal) e Português (Brasileiro). A localidade padrão do WordPress é o inglês (EUA). Para definir uma localidade, usamos um código de idioma + um código de país ou o código ISO 639-3 de um idioma.. Em um post do Polyglots, Estela Rueda criou um tópico justamente para discutir como aumentar a quantidade de conteúdo em outros idiomas.

Pelo que eu entendi, estuda-se incluir a documentação no GitHub ou no translate.wordpress.org para que membros internacionais possam contribuir diretamente de forma facilitada.

Esse post me deixa contente justamente por sinalizar que há alguma preocupação internacional com o tema.

O que fazer agora?

Na minha opinião, o que podemos fazer no curto prazo é o seguinte:

Participar da discussão internacional: eu vou preparar uma resposta de acordo com o que foi solicitado
Continuar o trabalho de tradução da documentação como foi decidido aqui.

O que vocês me dizem? Alguém tem algo a acrescentar?

Wiliam Jose Koester 18:41 em 31 agosto, 2023

No post da Estela, ela pediu para as equipes internacionais responderem algumas perguntas:

1. Which content has been translated? How is the team keeping track of what has been translated?
2. What tools is your team using?
3. How is the site’s information architecture? How is search?
4. What results has the team had?
5. Are there any problems/issues the team is facing (besides the lack of contributors)?

O @rahmohn começou uma resposta lá no Slack pra gente e eu vou melhorar com base nela aqui, quero opiniões de vocês pra deixar bonitinho pra gente mandar pra Estela.

1. Nós começamos a traduzir, mas não terminamos. Houve um esforço em organizar esse processo, nós criamos um handbook com instruções e uma planilha do Google Drive para controlar o conteúdo traduzido, mas não chegamos em 10% feito. Além disso, como a planilha nunca mais foi atualizada, provavelmente a lista de conteúdo a traduzir deve estar defasada.
2. Há instruções de como traduzir no handbook, uma planilha do Google Drive para controle do conteúdo a ser traduzido e um canal dedicado ao tema no Slack da comunidade brasileira.
3. A página principal da documentação ainda está com o visual antigo da página de suporte. Nós tivemos o cuidado de tentar manter os links permanentes idênticos para que fosse fácil apenas adicionar o “br.” no início da URL. A intenção era reproduzir a estrutura de informação do site original.
4. O projeto simplesmente não foi para frente.
5. A barreira de entrada para colaboradores novos é muito grande e os GTEs atuais não têm disponibilidade para tocar sozinhos. Além disso, por mais que conseguíssemos traduzir tudo agora, em pouco tempo ficaria desatualizado e controlar isso é muito manual e trabalhoso.

Comentários adicionais: em nossa opinião, a tradução da documentação deveria ser tão fácil quanto a tradução de temas ou plugins, permitindo que qualquer pessoa envie uma sugestão de tradução facilmente. Além disso, nós deveríamos poder controlar, de alguma forma, se páginas são publicadas ou atualizadas.

O que vocês me dizem? Posso mandar?
Felipe Santos 14:36 em 4 setembro, 2023

Aqui estão as respostas se quiser usar como base (já comecei em ingles pra facilitar):
1. Which content has been translated? How is the team keeping track of what has been translated?

The Docs team (or someone on Meta) exported a list with all the HelpHub posts to a spreadsheet, so we edited the spreadsheet to keep track of all the edits.

Apart from that, we also had our local handbooks that were created using the international versions as a reference — we don’t keep track of these in any specific way and just edit them as needed.
2. What tools is your team using?

Basically, we only use the spreadsheet, and our workflow was to add access to everyone interested in contributing. Contributors would select it as translated, and someone would review it.
3. How is the site’s information architecture? How is search?

We’re using the HelpHub for Rosetta sites — we keep the same slugs for the English articles and a similar structure.
4. What results has the team had?

I believe we created a decent workflow and translated some articles, but we stopped the whole project after we realized how hard it would be to manage it in the long term.
5. Are there any problems/issues the team is facing (besides the lack of contributors)?

It’s generally challenging to contribute and not as easy as simply adding a new stringString Uma string é uma parte traduzível do software. Uma tradução consiste em uma infinidade de strings localizadas. translation on GlotPressGlotPress O GlotPress é o software de gerenciamento de traduções que funciona no Translate.WordPress.org. Mais informações estão disponíveis em glotpress.org..

Also, the whole updating process is frustrating — it is hard to reflect the changes from the English sites.

I believe we could now keep track of changes on the GitHub repo for the docs team, but it would still require us to fully read the GH issues and review the whole article instead of having a simple changelog. Having a more complete GlotPress-based solution here would be fantastic.
Felipe Santos 18:07 em 6 setembro, 2023

Pessoal, parece que a comunidade vai na direção de usar o GitHub pra gerenciar este conteudo: https://make.wordpress.org/project/2023/09/06/documentation-translation-localization/

cc @wiliamjk
Wiliam Jose Koester 17:37 em 8 setembro, 2023

Achei ótimas as respostas, compartilhei lá no formulário que ela pediu.

Sobre ir para o GitHub, confesso que não sei se é a minha opção favorita, mas fico feliz de que pelo menos estejamos indo para algum lugar.

Eu vou ficar de olho nisso e acho que, por enquanto, qualquer esforço de tradução da documentação seria desperdício de energia, certo? O ideal seria aguardar para ver como fica essa solução, o que acha?

Deixe um comentário Cancelar resposta

Você precisa fazer o login para publicar um comentário.

Contato

Discussão para uma proposta de tradução da documentação do WordPress para pt_BR

Compartilhe isso: