Analisar indicações no seu caso

Uma indicação (indication) é uma reivindicação nomeada de que algo precisa de melhoria. Um voto contra diz tem algo errado aqui; uma indicação diz o quê.

Abrir uma indicação é a análise. Não há etapa de aprovação atrás dela, nem fila de moderação em que ela espera — os outros criadores que referenciam o alvo veem a reivindicação assim que você a escreve.

Antes de começar

Você é dono de pelo menos um caso, que é o que abre a superfície de curadoria. Veja Trabalhar o catálogo de curadoria.
Você está com a fila aberta em /curation, com o alvo que lhe interessa na tela.

As duas ações abaixo acontecem em um painel que abre sob uma linha do catálogo. Uma linha oferece exatamente uma delas, e qual delas é uma propriedade da linha.

Abrir uma reivindicação

O botão da linha diz Raise quando nenhuma reivindicação está em aberto naquele alvo para você.

Clique em Raise na linha. Um painel abre embaixo dela.
Escreva o que precisa de melhoria, em What needs improvement. O texto de apoio diz a tarefa sem rodeios: “Name what is wrong — a downvote alone cannot”.
Clique em Raise indication.

Confirme que funcionou: o painel fecha, a fila é relida e a coluna Indication da linha passa a mostrar uma ficha Open.

O resumo tem limite de 4.000 caracteres. Deixá-lo em branco é recusado antes de qualquer envio:

Say what needs improvement before raising it.

Uma reivindicação viva por alvo

Um alvo carrega no máximo uma reivindicação em aberto. Se já houver uma, o servidor recusa a segunda:

indication <id> already stands on <TYPE> "<target>"; dispose of it instead of
raising another

<id>, <TYPE> e <target> vêm preenchidos com os valores reais. A recusa nomeia o caminho: julgue a reivindicação em aberto em vez de abrir uma rival.

“Em aberto” é perguntado para você. Um alvo que outra pessoa encerrou, ou que você encerrou e novos votos contra trouxeram de volta, pode receber uma nova reivindicação.

Você não precisa ser dono do alvo

Ser dono de um caso é o que abre a superfície de curadoria. Isso não é uma condição sobre o que você pode reivindicar: qualquer alvo da fila aceita uma reivindicação sua, inclusive uma tecnologia que você nunca provisionou e o caso de outra pessoa.

A propriedade volta a contar no julgamento, e só para um tipo de alvo — um caso só pode ser julgado pelo dono dele.

Registrar um julgamento

O botão da linha diz Dispose quando uma reivindicação está em aberto para você.

Clique em Dispose na linha. O painel abre, com o texto da reivindicação no topo, sob The standing claim.
Leia Already decided by other creators, se a seção estiver lá. Veja Adotar a correção de outro criador abaixo.
Escolha um Verdict: Resolved ou Won’t fix.
Escreva uma Note. Ela é obrigatória nos dois veredictos — um resolved diz o que foi corrigido, um won’t fix diz por que nada será. Deixá-la em branco é recusado antes de qualquer envio:

A note is required on both verdicts — say what was corrected, or why nothing will be.
Em um componente de conhecimento (knowledge component) que você está resolvendo, nomeie o Resolving component — veja Nomear a correção abaixo.
Clique em Record judgment.

Confirme que funcionou: o painel fecha, a fila é relida e a linha sai da visão padrão — ela está encerrada para você agora.

Cancel sai sem gravar nada.

Os dois veredictos encerram, e nenhum é aprovação

Resolved e Won’t fix encerram a reivindicação. Nenhum dos dois é um voto sobre se a reivindicação era boa, e não existe um terceiro estado em que alguém mais graduado dá a palavra final.

Para quem um julgamento encerra

Esta é a regra que vale aprender, porque os três alvos diferem:

Alvo	Seu julgamento encerra para
Componente de conhecimento	Só para você. Todos os outros criadores afetados ainda decidem por conta própria.
Tecnologia	Para todos. O primeiro criador a julgar encerra.
Caso	Para todos, e só o dono do caso pode julgar.

A razão é o alcance de uma correção. Corrigir um componente cria um componente novo, com id de referência novo, que não chega ao caso já publicado de mais ninguém — então cada criador afetado tem a própria decisão a tomar. A descrição de uma tecnologia (technology) é corrigida no lugar, então uma correção chega a todos os criadores.

Se outra pessoa encerrou primeiro, o servidor avisa:

curation indication <id> was already disposed of by <name>

Nomear a correção

Quando você resolve uma reivindicação sobre um componente de conhecimento, aparece o campo Resolving component. Ele nomeia o componente que responde à reivindicação — uma revisão (revision) nova, ou uma definição alternativa (alternative definition).

Comece a digitar parte de um id de referência ou parte do que um componente diz, e escolha entre as sugestões. O próprio alvo da reivindicação fica fora delas: um componente não pode resolver a si mesmo.

O campo só aparece onde pode significar alguma coisa:

Em uma tecnologia ou em um caso, nomear um componente é recusado com um 400. Corrigir qualquer um dos dois muda a coisa no lugar, então não há id novo para apontar.
Em um Won’t fix, nomear um componente também é recusado. Um won’t fix diz que nada mudou, então não pode nomear o que mudou.

Uma referência que não resolve para nada é recusada:

resolving knowledge component "<reference>" was not found

Adotar a correção de outro criador

Quando uma reivindicação já carrega julgamentos de outros criadores, eles ficam listados acima do controle de veredicto, do mais antigo para o mais recente — cada um com o nome do criador, o veredicto e a nota.

O lugar é deliberado: antes de você decidir, não depois. Onde um criador nomeou um componente que resolve, a entrada dele traz duas coisas:

a referência, como link que abre o componente em uma aba nova, para você ler a correção antes de endossá-la
um botão Adopt

Adopt preenche o componente que resolve com o dele e coloca o veredicto em Resolved, porque adotar uma correção é resolver.

Reivindicação encerrada não é assunto encerrado

Um julgamento tira o alvo da sua fila padrão. Ele não encerra o assunto.

O catálogo conta os votos contra desde o seu julgamento, então um alvo que você marcou como Won’t fix volta na hora se os aprendizes continuarem votando contra. São justamente as linhas que mais valem acompanhar, e por isso o texto da ficha diz que o veredicto não é definitivo.

Ligue Show analyzed na fila para ver o que você já julgou.

O que vem a seguir

Trabalhar o catálogo de curadoria — a fila de onde estas ações partem.
Corrigir ou aposentar um caso publicado — no que se transforma uma reivindicação resolvida sobre um caso seu.
Gerar e publicar componentes — de onde vem o componente corrigido que você nomeia.