Crowdin como fonte de medição

Recolha a atividade de tradução do Crowdin no Radar e utilize medições definidas para analisar o texto e o processo de edição.

Continue a criar e a rever traduções no Crowdin enquanto utiliza o Lingo.dev para analisar a sua qualidade. A ligação ao Crowdin recebe os eventos suportados ao nível das cadeias de texto e disponibiliza o respetivo texto como evidência para medições no Radar. As traduções e o workflow de publicação continuam no Crowdin.

No menu de navegação do Studio 2.5, abra Studio 2.5 → Integrações em vez de Definições → Integrações. As ligações existentes para estabelecer a ligação e efetuar a configuração continuam a funcionar.

Uma alteração ao texto de origem, uma nova sugestão, uma aprovação e uma atualização do texto de destino exportado correspondem a diferentes etapas do trabalho. A ligação preserva essas distinções para que cada medição possa analisar o texto ou a alteração de que realmente precisa. Não gera traduções nem envia texto corrigido de volta para o Crowdin.

Ligar a fonte #

  1. Na organização pretendida do Lingo.dev, abra Definições → Integrações e selecione Ligar junto ao Crowdin. Se a opção não estiver disponível, verifique se a organização tem acesso à funcionalidade.
  2. Introduza um Nome para a ligação. Para crowdin.com, deixe o campo Domínio Enterprise em branco. Para o Crowdin Enterprise, introduza a parte que precede .crowdin.com, por exemplo, acme, e selecione Ligar.
  3. Copie o URL do webhook fornecido. Em cada projeto do Crowdin que pretenda medir, abra Ferramentas → Webhooks e adicione um webhook com esse URL, o método POST e dados em formato JSON. Selecione os eventos de cadeias de texto suportados indicados abaixo.

Trate o URL do webhook como uma credencial: o recetor utiliza o segredo contido no URL para autorizar os eventos recebidos. Não o inclua em pedidos de suporte nem em ficheiros de repositórios. Uma única ligação da organização pode receber eventos de vários projetos; cada evento inclui a identificação do projeto a que pertence. Registe os projetos que configurou para saber o que será abrangido por um relatório posterior.

Selecionar os eventos de cadeias de texto necessários #

Subscreva os eventos suportados ao nível das cadeias de texto no Crowdin:

Eventos do CrowdinEvidências fornecidas
string.added, string.updated, string.deletedAtividade da cadeia de texto de origem.
suggestion.added, suggestion.updated, suggestion.deletedAtividade da tradução proposta.
suggestion.approved, suggestion.disapprovedAções de revisão de uma sugestão.
translation.updatedAlteração entre a versão anterior e a nova versão do texto de destino exportado.

Numa tradução exportada, um valor anterior vazio e um novo valor preenchido indicam uma criação. Dois valores preenchidos indicam uma atualização; um valor anterior preenchido e um novo valor vazio indicam uma eliminação. A aprovação de uma sugestão e a alteração do texto de destino exportado são eventos distintos.

Os eventos ao nível dos ficheiros, como file.approved e file.translated, não são convertidos em evidências de cadeias de texto por este adaptador. Os tipos de evento não suportados e os eventos sem identificação do projeto ou da cadeia de texto podem ser ignorados. Na primeira verificação, utilize um evento de cadeia de texto suportado, em vez de assumir que qualquer entrega bem-sucedida de um webhook comprova a existência de evidências utilizáveis.

Acompanhar uma alteração de tradução até à medição #

Utilize a medição incorporada de distância de edição neste primeiro teste. Esta medição é executada quando se cria ou atualiza texto de destino e compara o novo texto com a tradução anterior da cadeia de texto. Ative a medição no Radar antes de gerar a atividade de teste.

  1. Escolha um projeto, uma cadeia de texto e um idioma de destino que conheça e para os quais já exista uma tradução. Registe essa tradução e o texto que vai aprovar.
  2. Aprove uma sugestão editada através do workflow habitual de revisão do Crowdin e verifique a entrega de translation.updated ao webhook configurado.
  3. Localize o evento de destino correspondente no Lingo.dev. Compare o projeto, a chave legível, o idioma e o texto de destino do evento com o par de textos registado. Se a tradução anterior utilizada pela medição não for a que pretendia comparar, verifique os eventos anteriores da cadeia de texto antes de interpretar o valor da distância.
  4. Abra o resultado da distância de edição. Confirme a definição, os textos comparados e a resposta numérica obtida após a conclusão da medição. A referência das medições incorporadas explica o denominador utilizado e as limitações das unidades de caracteres.

Este teste liga uma ação do fornecedor à resposta que irá interpretar mais tarde. A primeira tradução de uma cadeia de texto não tem uma versão anterior, pelo que a distância de edição devolve 0. A aprovação em si é registada como suggestion.approved e não aciona nenhuma das medições de edição. As verificações incorporadas de glossário e de regras utilizam eventos de localização concluída, não edições ou aprovações do Crowdin. Para medir outro tipo de evento, configure uma medição personalizada para esse evento específico e para as evidências disponíveis; não é possível reatribuir os acionadores incorporados.

As marcas temporais e as identidades dos eventos ajudam a associar um registo à sua origem, mas o seu significado depende da atividade. Os eventos de tradução e de sugestão, incluindo as aprovações, usam o createdAt da tradução; uma aprovação recebida hoje pode surgir com uma data de criação anterior. A hora de receção permite distinguir rejeições repetidas da mesma sugestão e substitui marcas temporais em falta ou inválidas; cada aprovação é registada apenas uma vez por sugestão. Verifique o eventAt registado ao filtrar Eventos ou ao selecionar um período histórico de medição. Uma extração posterior do texto não permite voltar a associar, de forma fiável, todos os eventos sem marca temporal. A falta de informação sobre a autoria também não justifica atribuir um evento a uma pessoa ou a um modelo sem provas.

Interpretar os resultados tendo em conta a cobertura #

Os webhooks recolhem a atividade configurada a partir do momento em que esta é entregue. Não permitem reconstituir todas as traduções anteriores, revisões do texto de origem ou o histórico do projeto. A falta de texto nos dados enviados, os eventos não suportados e os projetos não configurados podem limitar o que está disponível para medição. As entregas repetidas de ações de revisão podem gerar registos de evidências separados, pelo que o número de eventos não corresponde necessariamente ao número de traduções distintas revistas.

Separe os registos que não cumprem um critério dos registos aos quais o critério se aplica, mas que não incluem o texto necessário. Nas avaliações, distinga as respostas concluídas, as respostas concluídas com resultado indeterminado e o trabalho ainda sem resposta concluída. Uma resposta indeterminada regista uma avaliação concluída, mas não permite concluir que houve aprovação ou reprovação.

Ao apresentar uma taxa de aprovação, utilize como denominador as respostas com resultado determinado e indique a proporção de conteúdo elegível que recebeu uma dessas respostas. A ausência de avaliação não demonstra má qualidade da tradução, e uma aprovação no Crowdin reflete o processo de revisão desse projeto, não constituindo, por si só, uma prova de correção semântica. Conceber uma medição da qualidade da tradução aprofunda o cálculo e a interpretação.

Resolver problemas de entrega ou desativar a fonte #

Se deixarem de aparecer evidências, verifique as subscrições de webhooks do projeto, o tipo de evento, os erros de entrega e o URL de destino. Confirme que o webhook envia pedidos POST com dados em JSON para o URL atual do webhook da ligação. A ligação não recupera automaticamente os eventos perdidos. Para avaliar eventos já recolhidos no Lingo.dev, utilize o workflow de medição histórica.

Se o URL do webhook for exposto ou precisar de ser substituído, abra a ligação em Definições → Integrações, escolha Renovar e confirme com Renovar URL. O URL antigo deixa de funcionar imediatamente. Copie o novo URL para todos os projetos do Crowdin configurados e, em seguida, verifique a entrega de um evento suportado e as respetivas evidências no Radar.

Desligar a fonte interrompe a receção de novas evidências através da ligação; as medições registadas são mantidas. Remova separadamente os webhooks dos projetos do Crowdin. As traduções e as ações de revisão no Crowdin permanecem inalteradas. Nos relatórios que abranjam uma interrupção da ligação, tenha em conta o período sem recolha, em vez de o interpretar como um período sem trabalho de tradução.