Checklist: Regras de Redação, Posicionamento e Exemplos

Uma checklist é um conjunto finito de ações independentes ou portões de verificação que um leitor pode marcar como incompleto ou completo. Seu estado verificável faz parte do significado: completar cada item obrigatório deve provar que uma tarefa, revisão ou condição de prontidão nomeada está concluída.

Este exemplo renderizado possui um escopo delimitado, quatro ações concisas, estados não marcados visíveis e uma condição de conclusão. Converter as mesmas palavras em marcadores decorativos removeria a promessa de que o conjunto pode ser finalizado.

Por que este elemento é importante

Os leitores usam uma checklist para aliviar a memória. Em vez de manter todos os requisitos em mente enquanto alternam entre um rascunho, navegador, design e interface de publicação, eles podem inspecionar uma condição por vez e registrar o progresso. O limite finito reduz a incerteza: o leitor sabe o que resta, o que “concluído” significa e quando é seguro prosseguir.

Esse contrato psicológico é mais forte do que “aqui estão algumas ideias úteis”. Uma caixa de seleção convida ao compromisso, enquanto o último item não marcado cria tensão deliberada. O elemento deve, portanto, ser honesto sobre o escopo. Se a lista omitir um portão obrigatório ou incluir aspirações vagas como “tornar a página excelente”, a interface sinaliza uma certeza que o conteúdo não conquistou.

A extraibilidade por máquina é a capacidade de mecanismos de busca, sistemas de IA, tecnologia assistiva e ferramentas de publicação de isolar cada item sem perder seu papel ou modelo de conclusão. Uma checklist tipada expõe uma coleção nomeada, limites estáveis de item, estados iniciais e uma condição de conclusão. Um parser pode distinguir portões obrigatórios de exemplos ou benefícios, enquanto um sistema de IA pode citar uma ação autossuficiente com o assunto da checklist intacto.

Siga as regras de redação de elementos antes de escolher o componente. Sua regra de precedência é semântica: quando o propósito de um bloco é ser concluído ou verificado, use o elemento de checklist mesmo que marcadores comuns pudessem exibir as mesmas palavras. A semelhança visual não preserva estado, validação, acessibilidade ou mapeamento de adaptador.

Quando usar

Use uma checklist quando o conjunto for finito, cada item puder passar ou falhar independentemente, e completar os itens obrigatórios estabelecer uma condição significativa. Assuntos apropriados incluem revisão pré-publicação, requisitos de aquisição, prontidão de migração, handoff de incidente, completeza de documento, revisão de acessibilidade e inspeção de manutenção recorrente.

Aplique três testes:

1. Teste de estado: Cada item pode ser inequivocamente marcado como incompleto ou completo?
2. Teste de limite: A lista contém todas as verificações obrigatórias para seu escopo declarado?
3. Teste de conclusão: Finalizar os itens obrigatórios prova um resultado nomeado?

Se alguma resposta for não, outro elemento provavelmente é mais preciso. Os quase-acertos comuns são:

• Uma lista de marcadores agrupa fatos, opções, exemplos ou atributos. Seus itens não são tarefas e o conjunto não se torna completo.
• Uma lista de etapas codifica sequência dependente. Se mover o item 4 antes do item 2 puder causar falha, números e orientações de recuperação são mais importantes que caixas de seleção.
• Uma lista de recursos descreve o que um produto possui. “Suporta exportação CSV” não é uma verificação, a menos que o leitor esteja verificando um requisito declarado.
• Uma lista de desejos registra preferências cujos limites e prioridade podem mudar. Não deve prometer conclusão.
• Um scorecard avalia dimensões em uma escala. Estados binários de verificação descartariam graus úteis de desempenho.
• Um procedimento longo com uma caixa de seleção ao lado de cada clique confunde execução com verificação. Explique o procedimento como etapas e depois adicione uma checklist curta de conclusão.

Não use uma checklist como decoração no final de cada seção. Caixas não marcadas repetidas impõem trabalho e sugerem que o leitor não terminou, mesmo quando o conteúdo apenas ofereceu conselhos opcionais.

Onde posicionar

O posicionamento segue o momento em que o leitor pode agir ou verificar. Apresente a tarefa, o escopo e o contexto necessário primeiro; depois, coloque a checklist imediatamente antes da decisão que ela controla ou imediatamente após o material que ela resume.

• Coloque uma checklist de prontidão após os pré-requisitos e antes de uma ação irreversível ou cara.
• Coloque uma checklist de garantia de qualidade após o rascunho, configuração ou procedimento que ela avalia e antes da aprovação ou publicação.
• Coloque uma checklist de requisitos de compra depois que as necessidades e restrições forem explicadas, mas antes que os produtos sejam pré-selecionados.
• Coloque uma checklist de inspeção recorrente dentro da seção de manutenção, ao lado de sua cadência e responsável.
• Coloque a checklist principal perto do topo de um artigo de checklist dedicado, após uma declaração de escopo curta, e explique os itens difíceis abaixo.

Uma checklist não deve ficar diretamente ao lado de uma segunda checklist com escopo sobreposto; mescle-as ou dê a cada uma um título distinto e condição de conclusão. Não a coloque ao lado de uma lista de etapas sequencial sem declarar qual bloco é o procedimento e qual é a verificação. Ela não deve separar um aviso da consequência ou resposta necessária, interromper uma tabela de comparação ou ficar dentro de uma chamada para ação. Nunca coloque um botão promocional entre o item final e a condição de conclusão.

Anatomia

As regiões rotuladas são:

1. Título de escopo: nomeia o objeto exato e a decisão, como “Verificação de links pré-publicação.”
2. Instrução: diz o que a conclusão permite ou prova.
3. Controle de caixa de seleção: expõe o estado incompleto ou completo de forma programática e visual.
4. Rótulo de ação: começa com um verbo concreto e permanece compreensível por si só.
5. Qualificador opcional: fornece um limite, localização, responsável ou requisito de evidência.
6. Indicador de obrigatório: distingue itens opcionais apenas quando o contrato genuinamente os permite.
7. Resumo de progresso: relata itens concluídos e totais obrigatórios em variantes interativas.
8. Condição de conclusão: declara o resultado estabelecido quando todos os itens obrigatórios passam.

As palavras permanecem autoritativas. Um ícone de visto, linha verde ou rótulo tachado pode reforçar o estado, mas nenhum pode substituir o estado marcado nativo ou programático.

Exemplos de design

Checklist editorial estática

Use controles não marcados visíveis para uma checklist imprimível ou de referência. O leitor pode copiá-la ou imprimi-la, mas a página não afirma salvar progresso.

Checklist de progresso interativa

Use quando o leitor se beneficia de marcar progresso durante uma sessão. Anuncie a contagem sem mover o foco e forneça uma ação clara de redefinição.

Checklist obrigatória e opcional

Use apenas quando tarefas opcionais genuinamente não afetam a condição de conclusão. Rotule itens opcionais em texto; nunca dependa apenas de cor mais clara.

Checklist agrupada

Para mais de dez verificações no total, divida o trabalho em grupos de quatro a dez com títulos separados e condições de conclusão. Cada grupo é compreensível independentemente.

Estado de impressão

A saída de impressão deve reter marcas vazias e concluídas em preto e branco, manter os rótulos ao lado de seus controles e evitar dividir um grupo curto entre páginas.

Parâmetros

O valor inicial checked é para exemplos práticos, modelos salvos ou estado de tarefa de propriedade do servidor. Checklists editoriais começam desmarcadas; autores nunca devem pré-marcar um item apenas para criar uma captura de tela mais atraente. Se interactive=false, persist deve ser none.

Sintaxe e exemplos de código

O mapeamento canônico segue as regras de precedência, corpo e item aninhado do contrato base. O pai fornece o comportamento de coleção; cada item fornece um rótulo, detalhe opcional e campos de estado.

Diretiva Markdown portátil

:::checklist{id="pre-publish-links" interactive=true persist=local}
## Verificação de links pré-publicação

Complete todos os itens obrigatórios antes de aprovar a página.

::item
### Abra cada link interno e confirme que o destino existe
::

::item
### Confirme que cada âncora descreve seu destino fora de contexto
::

::item{required=false}
### Verifique parâmetros de campanha em links promocionais opcionais
::

::item
### Verifique se o foco do teclado está visível em cada controle vinculado
::

Complete quando todos os itens obrigatórios passarem e nenhuma exceção permanecer.
:::

Shortcode Hugo

{{< checklist id="pre-publish-links" title="Pre-publish link check" interactive="true" persist="local" completion="Complete when every required item passes and no exception remains." >}}
{{< checklist-item >}}Open every internal link and confirm the destination exists.{{< /checklist-item >}}
{{< checklist-item >}}Confirm each anchor describes its destination out of context.{{< /checklist-item >}}
{{< checklist-item required="false" >}}Check campaign parameters on optional promotional links.{{< /checklist-item >}}
{{< checklist-item >}}Verify keyboard focus is visible on every linked control.{{< /checklist-item >}}
{{< /checklist >}}

Este é o formato de adaptador Hugo exigido, não uma afirmação de que o repositório já fornece o shortcode. Até que um renderizador registrado exista, use HTML semântico para um exemplo real em vez de imitar o componente com estilos não relacionados.

Bloco WordPress

<!-- wp:amicited/checklist {"id":"pre-publish-links","title":"Pre-publish link check","interactive":true,"persist":"local","completion":"Complete when every required item passes and no exception remains."} -->
<!-- wp:amicited/checklist-item -->
<p>Open every internal link and confirm the destination exists.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Confirm each anchor describes its destination out of context.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item {"required":false} -->
<p>Check campaign parameters on optional promotional links.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Verify keyboard focus is visible on every linked control.</p>
<!-- /wp:amicited/checklist-item -->
<!-- /wp:amicited/checklist -->

Todos os adaptadores devem preservar a ordem de origem, o estado obrigatório, os rótulos visíveis, a condição de conclusão e o conteúdo não marcado quando a scriptagem não estiver disponível.

Exemplos

Bom: uma verificação de lançamento delimitada

• Confirme que a versão de lançamento corresponde ao registro de alteração aprovado.
• Execute o teste de smoke documentado e anexe seu resultado.
• Verifique se o responsável pelo rollback está disponível durante a janela de lançamento.
• Registre o horário de implantação na linha do tempo do incidente.

Complete quando: todos os quatro registros estiverem presentes e o responsável pelo rollback nomeado tiver confirmado a janela.

Isso funciona porque cada item começa com uma ação observável, permanece dentro de uma decisão de lançamento e possui evidência binária. A linha de conclusão explica o que o conjunto completo prova.

Ruim: uma lista de conteúdo aspiracional

• Pense no público.
• Torne o artigo envolvente.
• Melhore o SEO.
• Adicione qualquer outra coisa que ajude.

Isso falha porque nenhum dos itens define uma condição de aprovação, “qualquer outra coisa” torna o conjunto infinito, e marcar as caixas não provaria que o artigo está pronto. Substitua aspirações por portões verificáveis, como “Nomeie um público principal no briefing” ou mova orientações não acionáveis para a prosa.

Marcação Schema e acessibilidade

Não existe um tipo Checklist geral no Schema.org. Não mapeie verificações independentes para HowToStep a menos que a página descreva genuinamente um procedimento ordenado e o conteúdo visível contenha essas etapas. Uma checklist pode permanecer como conteúdo visível dentro de Article, TechArticle, Product ou outro tipo de página justificado, mas suas caixas de seleção não criam elegibilidade extra de schema.

Use controles nativos <input type="checkbox"> para estado interativo e associe cada controle a um <label> usando encapsulamento ou valores for e id correspondentes. Uma exibição estática que não pode ser alterada não deve se passar por um controle habilitado. Use caixas de seleção desabilitadas para um exemplo explicitamente não interativo, ou use uma lista com equivalentes textuais como “Não marcado” em contextos onde controles de formulário seriam enganosos.

Usuários de teclado devem alcançar cada caixa de seleção habilitada na ordem de origem, alterná-la com a tecla Espaço e ver um indicador de foco persistente. Não mova o foco após uma marcação. Se uma mensagem de progresso for atualizada, anuncie um resumo conciso como “Quatro de seis itens obrigatórios completos” por meio de uma região ativa educada; não anuncie a lista inteira novamente.

Estados marcados e não marcados exigem mais que cor. Preserve o rótulo quando marcado em vez de substituí-lo por “Feito”, porque a ação deve permanecer identificável. Se o progresso persistir, explique o escopo do armazenamento e forneça “Redefinir progresso”. O conteúdo útil, os indicadores obrigatórios e a condição de conclusão devem permanecer em HTML renderizado no servidor quando o JavaScript falhar.

Regras de redação

Itens de checklist são compactos porque o leitor está executando ou verificando, não aprendendo o assunto inteiro dentro do controle. Explique a razão na prosa circundante antes de declarar a regra.

• Mantenha uma checklist com quatro a dez itens. Quatro estabelece um conjunto finito útil; mais de dez se torna difícil de escanear e sinaliza múltiplas fases.
• Mantenha cada ação com cerca de 80 caracteres e três a doze palavras. Um rótulo curto permanece utilizável ao lado de um controle e extraível sem prosa adjacente.
• Comece com um verbo imperativo específico: Confirme, Abra, Compare, Registre, Teste, Anexe ou Verifique. Evite verbos fracos como Considere, Lembre-se ou Pense sobre.
• Dê a cada item uma condição de aprovação. “Verifique o título e os links” pode ser aprovado parcialmente, então divida em dois itens.
• Mantenha os itens independentes. Se uma ação desbloqueia a próxima, converta o procedimento em etapas e use a checklist apenas para verificação final.
• Mantenha a gramática e o nível paralelos. Não misture “Confirme a aprovação legal” com “Publique a campanha em todos os canais e monitore-a por uma semana.”
• Nomeie a evidência quando a conclusão não for diretamente visível: anexe o relatório, registre o timestamp ou obtenha a confirmação do aprovador.
• Marque itens opcionais explicitamente e exclua-os do progresso obrigatório. Opcional deve significar que a condição de conclusão permanece verdadeira sem eles.
• Use caixa de frase e pontuação terminal de forma consistente. Frases completas são preferidas quando um item inclui um qualificador.

Nunca coloque estes itens dentro de um item de checklist:

• Várias subetapas ordenadas, lógica de solução de problemas ramificada ou uma segunda checklist aninhada.
• Um aviso de segurança, isenção legal ou consequência irreversível que deve ser vista antes da ação.
• Um parágrafo de explicação, citação longa, depoimento, captura de tela, vídeo, formulário ou chamada para ação promocional.
• Uma pontuação subjetiva, aspiração de final aberto, limite não fundamentado ou requisito sem evidência observável.
• Um link rotulado apenas como “aqui”, porque o item deve sobreviver à extração sem contexto circundante.

Tipos de post que o utilizam

As associações abaixo são orientadas pelo postTypes do frontmatter desta página. “Obrigatório” significa que a tarefa central do tipo de post depende de um modelo de conclusão finito; “recomendado” e “opcional” dependem do assunto da página.

Checklist de QA

Conteúdo e posicionamento

• O título nomeia um objeto delimitado, decisão ou estado de prontidão.
• A introdução explica o que completar os itens obrigatórios prova.
• Use quatro a dez itens, dividindo trabalhos maiores em grupos nomeados.
• Mantenha cada item próximo de 80 caracteres e comece com um verbo concreto.
• Cada item tem uma condição de aprovação observável e pode ser verificado independentemente.
• Confirme que reordenar itens não quebra a tarefa.
• O conjunto é finito e inclui todos os portões obrigatórios para seu escopo declarado.
• Itens opcionais são visivelmente rotulados e excluídos do progresso obrigatório.
• Remova procedimentos aninhados, avisos, explicações longas, mídia e promoção.

Complete quando: a coleção tem um propósito delimitado e cada item é conciso, independente e verificável.

Renderização e acessibilidade

• A condição de conclusão aparece diretamente após o item final.
• Controles habilitados têm rótulos associados, operação por teclado e foco visível.
• O estado não é comunicado apenas por cor, ícones, tachado ou posição.
• O progresso interativo funciona sem mover o foco e explica qualquer persistência.
• Rótulos e critérios de conclusão permanecem disponíveis sem CSS ou JavaScript.
• Mantenha dados estruturados na página que os contém; não invente esquema de Checklist.
• Preserve os mesmos campos e ordem em todos os três mapeamentos de plataforma.
• Mantenha comentários de captura de tela como instruções; não referencie imagem ausente.

Complete quando: estado, rótulos, ordem e significado de conclusão sobrevivem a todos os caminhos de renderização suportados.

FAQ

O template da academia renderiza as cinco perguntas revisadas no [[faq]] do frontmatter desta página. Elas cobrem quantidade de itens, a distinção de marcadores e etapas, estado salvo e dados estruturados.