Publique um FAQ para as IAs, uma pergunta de cada vez

As respostas você já escreveu. Elas vivem em uma página só, dobradas em um acordeão, cada uma atrás de um clique. É confortável para um visitante que procura a própria pergunta com os olhos, e é mais ou menos o arranjo mais hostil que existe para o que lê sem clicar.

Uma pergunta, um endereço

A unidade que se cita é um endereço. Uma página que responde a uma única pergunta pode ser lida, citada e linkada por si mesma; a mesma resposta, oitava de uma lista de vinte, chega com outras dezenove penduradas e sem nenhum jeito de apontar para ela.

A pergunta vira então o título da página, e a resposta vira o texto dela. markleex.com/@seunome/faq/voces-entregam-no-brasil-todo é um documento inteiro, e diz uma coisa só.

Diga que é uma pergunta

Coloque question: true na cabeça da página e os dados estruturados dizem o que a página é: o título é publicado como a pergunta, e o texto como a resposta aceita dela. Um leitor que nunca vê as suas palavras sabe mesmo assim qual parte se pergunta e qual parte é a resposta.

A página de cabeça que lista todas não leva essa marcação, e é de propósito: ela mostra títulos, não respostas, e nossa marcação nunca afirma mais do que a página mostra de verdade.

Mantenha as perguntas juntas

Publique uma página de cabeça com children: true e ela serve a lista de todas as perguntas arquivadas embaixo, sem você ter que cuidar dessa lista. Acrescente children_order: manual e uma posição em cada página se a ordem importar, o que costuma ser o caso: o que se pergunta primeiro vem primeiro.

Que perguntas escrever

As que fazem de verdade, com as palavras das pessoas, não as que você gostaria que fizessem.

• Quanto custa, ou como se orça quando varia.
• Quanto tempo leva, contando do dia em que alguém diz sim.
• Onde você atende, e onde não atende.
• O que não está incluído: a resposta que ninguém publica e de que todo mundo precisa.
• O que acontece quando dá errado: devoluções, garantia, o que você cobre.
• Como se começa, em tão poucos passos quanto for honesto anunciar.

Depois você descobre quais contam

As leituras se contam por endereço, então cada pergunta conta a você quantas vezes foi lida e por quais casas de IA. Um acordeão nunca vai conseguir dizer isso: é uma página só, e todas as respostas que ela contém dividem o mesmo número.

As perguntas que voltam e que ainda não têm página são as que vale a pena escrever depois, e o ciclo se fecha.

Como fazer

1. Liste as perguntas que fazem de verdade, com as palavras usadas para fazê-las.
2. Publique uma página por pergunta, a pergunta como título e a resposta como texto.
3. Acrescente question: true em cada uma, para o marcado dizer que é uma pergunta e a resposta dela.
4. Publique uma página de cabeça com children: true, que serve a lista de todas.
5. Veja quais perguntas são lidas, e escreva as respostas que faltam.

Se o FAQ já existe em algum lugar, conecte seu assistente ao Markleex e dê a página a ele: ele fatia em uma página por pergunta e publica todas, com as chaves, de uma vez só.

Quanto custa

Um espaço custa US$ 0,83 por mês, com 10 páginas incluídas, de modo que as perguntas que mais fazem a você já ficam cobertas antes de acrescentar qualquer coisa. Ver os preços.