Os sistemas de IA não conseguem seguir as tuas instruções como uma pessoa. Uma pessoa lê "clica no botão Definições" e percebe logo. Um sistema de IA precisa que o texto esteja tão bem estruturado que os erros de extração se tornem impossíveis. Acertar nisto significa que o teu guia prático é citado. Errar significa que a IA o ignora e recomenda o teu concorrente.
A diferença resume-se a três coisas: como numeras os passos, como usas os títulos para organizar a informação e se aplicas schema HowTo para tornar a tua estrutura legível por máquinas.
Como numeras os passos para que os leitores e a IA os percebam da mesma forma?
Cada passo é uma ação. Só uma ação. Não uma ação com três subações escondidas numa frase comprida.
Escreve na forma imperativa. Diz ao leitor o que fazer: "Clica no botão Definições." Não "Deves clicar no botão Definições" nem "Cliquei no botão Definições." A forma imperativa é a mais clara para instruções.
Mantém cada passo em uma ou duas frases. Um passo com mais de duas frases contém várias ideias. Divide-o em passos separados.
Exemplo de um passo fraco: "Vai às Definições, que estão no menu do canto superior direito, e procura a secção Segurança. Clica nela e depois encontra a Autenticação de dois fatores e clica em ativar."
É um só passo mas contém cinco ações. A IA vai ter dificuldade em extraí-lo corretamente.
Versão melhor:
1. Clica em Definições no canto superior direito. 2. Seleciona Segurança. 3. Clica em Ativar junto a Autenticação de dois fatores.
Agora cada passo é uma ação. A IA consegue extrair cada passo de forma independente e ainda assim fazer sentido.
Que informação deve vir antes dos passos propriamente ditos?
Diz aos leitores o que precisam antes de começar. Põe isto numa tabela para ser fácil de percorrer:
| O que precisas | Detalhes |
| Tempo | 5 minutos |
| Ferramentas | Telemóvel, email |
| Tipo de conta | Qualquer conta serve |
Esta tabela responde às perguntas que os leitores fazem antes de começar. Também ajuda a IA a perceber se o guia está completo e se o leitor está apto a segui-lo.
Como deves organizar as secções dentro do teu guia prático?
Usa títulos claros que indiquem o que vem a seguir. "O que vais precisar" indica uma secção de pré-requisitos. "Os passos" indica que vêm as instruções. "O que fazer se isto acontecer" indica a resolução de problemas.
Não uses títulos com dois pontos ou pontos de interrogação. Usa títulos simples e diretos:
O que vais precisar (não "O que vais precisar: pré-requisitos e ferramentas") Os passos (não "Os passos: como configurar a autenticação") Problemas comuns e como os resolver (não "Resolução de problemas: o que fazer se X")
Isto mantém os títulos limpos e indica o conteúdo com clareza.
Deves incluir imagens no teu guia prático?
Sim, mas só quando acrescentam clareza. Inclui uma imagem quando o leitor precisa de ver como algo se parece ou onde está. Não acrescentes capturas de ecrã só para ter imagens.
Se incluíres uma imagem, coloca-a logo a seguir ao passo que ilustra. Escreve uma legenda que descreva o que a imagem mostra: "Imagem: o botão Definições está no canto superior direito da página da conta."
A legenda ajuda os leitores e a IA a perceber o que estão a ver.
O que faz o schema HowTo por ti?
O schema HowTo são dados estruturados que dizem ao Google e aos sistemas de IA "isto é um guia prático com passos numerados". Sem schema, a IA tem de adivinhar onde os passos começam e acabam. Com schema, a estrutura é explícita.
Quando usas o schema HowTo, indicas o nome da tarefa, o tempo estimado para a concluir, que ferramentas ou conhecimentos o leitor precisa e cada passo por ordem.
Estes metadados ajudam a IA a perceber não só o que extrair, mas se o guia está completo. Se o teu guia diz que demora 10 minutos mas tem 20 passos, a IA marca-o como possivelmente incompleto ou impreciso.
O WEMASY aplica o schema HowTo automaticamente quando usas o tipo de conteúdo How-To, por isso a marcação é tratada por ti.
O que vem depois dos passos numerados?
Quando os passos principais estão feitos, acrescenta detalhe de apoio. Explica porque cada passo importa ou a que deves estar atento. Usa subtítulos para cada passo:
Passo 1: clica em Definições
As Definições são onde ficam todas as preferências da conta. No computador, as Definições aparecem no canto superior direito. No telemóvel, aparecem no menu hambúrguer.
Este detalhe de apoio ajuda os leitores a perceber o contexto sem atulhar o processo principal. A IA pode extrair apenas os passos numerados, se for preciso, mas os leitores ficam com o quadro completo.
O que pertence a uma secção de dicas ou avançada?
Se tens variações avançadas ou atalhos, põe-nos numa secção separada depois dos passos principais. Isto mantém o processo principal limpo. Os leitores que precisam da versão avançada encontram-na. Os leitores que só precisam dos passos básicos não ficam confusos.
Exemplo:
Avançado: método mais rápido para utilizadores experientes
Se já usaste isto antes, podes saltar o passo 2 e ir diretamente para o passo 3. O sistema preenche automaticamente as definições por defeito.
Como sabes se o teu guia prático está bem estruturado?
Lê só os passos numerados. Formam um processo completo e compreensível sem qualquer outro texto? Se sim, a tua estrutura é boa. Se precisas do detalhe de apoio para perceber um passo, ainda não o decompuseste com clareza suficiente.
Verifica também: cada passo é uma única ação? Alguém consegue seguir só os passos numerados e ter sucesso? Se a resposta for sim às duas, o teu guia prático está pronto.
Perguntas frequentes
Quantos passos são demasiados?
Não há um máximo fixo. Os bons guias práticos têm entre 3 e 15 passos. Se tens 25 passos, considera dividir o guia em guias mais pequenos e focados. Cada guia deve ensinar uma tarefa completa. Com o criador de websites do WEMASY, podes configurar isto diretamente no teu website.
Todos os passos devem ter uma imagem?
Não. Inclui imagens apenas onde acrescentam clareza. Uma instrução em texto "Clica no botão azul" pode precisar de uma imagem se o botão for difícil de encontrar. Uma instrução em texto "Escreve a tua palavra-passe" não precisa de imagem.
E se um passo exigir conhecimento prévio?
Acrescenta-o à secção "O que precisas" antes dos passos. Exemplo: "Este guia assume que já criaste uma conta." Ou: "Vais precisar de um número de telemóvel para concluir este guia."
Posso usar marcadores em vez de números?
Para passos, usa números. Os números indicam sequência e ordem. Os marcadores indicam uma lista de itens iguais. Os passos têm uma ordem, por isso usa números.
Com que frequência devo atualizar o meu guia prático?
Se o processo mudar, atualiza de imediato. Se a interface mudar (localização de botões, nomes de menus), atualiza essas referências. Se tens novas dicas ou erros comuns, acrescenta-os à secção de detalhe de apoio.
Preciso do schema HowTo se o meu guia já fica bem classificado sem ele?
O schema HowTo melhora as taxas de citação pela IA. Mesmo que o teu guia fique bem classificado, o schema ajuda a IA a recomendá-lo. Vale a pena acrescentá-lo.