Recomendações

Trabalhe as filas de recomendação para transformar o que as varreduras e as auditorias encontraram em coisas que você realmente faz.

Visão geral das recomendações

As recomendações estão divididas em três filas na barra lateral — Contexto, Técnico e Conteúdo — com a contagem de itens abertos ao lado de cada uma. Não existe uma lista combinada: você trabalha uma categoria por vez, porque as três exigem pessoas diferentes e volumes de esforço diferentes.

Os cartões são gerados a partir dos seus dados, não escritos à mão. Eles são atualizados depois de cada varredura e de cada auditoria, e a tela avisa quando isso está acontecendo em vez de mostrar cartões desatualizados.

Cada cartão traz uma faixa de prioridade, um impacto estimado e um rótulo de esforço, e a fila já chega ordenada — então o topo da lista é por onde começar.

Esta página cobre o que é comum às três. Para o que aparece em cada fila, veja Contexto, Técnico e Conteúdo.

Como trabalhar um cartão

1. Clique em Ver detalhes para abrir o cartão.
2. Leia O problema — o que foi encontrado, e onde.
3. Leia Por que isso importa — o que custa a você deixar isso como está.
4. Siga Como fazer. Os cartões de Contexto levam direto para a tela onde a correção acontece; os de Técnico trazem um Snippet pronto para usar com um botão Copiar; os de Conteúdo levam a um brief.
5. Defina o status quando terminar.

Voltar às recomendações leva você de volta à fila.

Como mudar o status de um cartão

Os botões em um cartão definem em que ponto ele está:

• Em andamento — você começou. Use isso para que um colega de equipe não pegue o mesmo cartão.
• Concluída — terminado.
• Ignorar — você não vai fazer este. Ele sai da fila sem fingir que está concluído.
• Reabrir — devolve à fila um cartão fechado.

Você também vai ver Resolvida em cartões que nunca tocou. É o aplicativo fechando um cartão por conta própria porque a varredura ou a auditoria seguinte não detecta mais o problema — o desfecho habitual de uma correção técnica que você publicou.

Vale saber Um cartão que você começou fica protegido. Uma vez que o status dele deixa de ser Aberta, a regeneração que roda depois de cada varredura para de sobrescrever o conteúdo dele, então as instruções com que você está trabalhando não mudam no meio da tarefa.

Como registrar o que você publicou

Os cartões de Conteúdo fecham de outro jeito: eles não se resolvem sozinhos, porque nada em uma varredura consegue dizer que o artigo que você escreveu é aquele que foi pedido.

Quando você publica, marque o cartão como Concluída. A caixa de diálogo oferece registrar o link:

1. Cole a URL.
2. Escolha o papel dela — Original para a versão principal, Reescrita para uma versão adaptada nativamente a outra plataforma, Link cruzado para um link ao seu original a partir de uma página existente.
3. Adicione mais URLs se você publicou em vários lugares, depois salve.

Você pode deixar em branco e adicionar os links depois. Adicionar um coloca aquela página nas suas fontes acompanhadas, para que as varreduras futuras possam dizer se ela está sendo citada.

Para o checklist de publicações e os briefs em si, veja Briefs de conteúdo.

O que a fila diz quando está esperando

A tela é explícita sobre por que não tem nada para você, em vez de mostrar uma lista vazia:

• Antes de a sua primeira varredura terminar — “Preparando suas recomendações…”
• Enquanto uma nova varredura está rodando — a fila é atualizada automaticamente quando ela termina.
• Enquanto os cartões estão sendo regerados — “Atualizando as recomendações com os dados mais recentes…”, normalmente em menos de um minuto.
• Quando realmente não há nada — cada categoria diz isso com as suas próprias palavras.

Você também vai ver um aviso quando há mais itens esperando do que a tela mostra. Eles aparecem à medida que você conclui os que estão na frente, de modo que a fila continua sendo uma lista de tarefas e não um acúmulo.

Vale saber Se o seu plano roda poucas amostras por prompt, a tela avisa que essas recomendações têm menos confiança. As medições por trás delas são mais ruidosas, e os briefs de conteúdo são os mais afetados.