Como escrever instruções claras para concluir uma tarefa

Defina o resultado e os requisitos para começar

Comece com uma tarefa reconhecível. Reservar uma sala de reunião é diferente de pedir autorização para um evento. Se o serviço separar essas ações, não junte ambas numa expressão vaga como «pedido». A pessoa precisa saber se está no percurso certo antes de investir tempo.

Indique os requisitos que podem impedir a conclusão: perfil autorizado, credenciais, documentos ou informações. Verifique quais são obrigatórios, em vez de inventá-los para preencher um modelo. Uma condição descoberta no último passo pode tornar inútil o trabalho anterior.

Esta explicação usa um serviço fictício de reserva de materiais de laboratório. O exemplo serve para avaliar a escrita e não descreve um portal existente. Para aplicá-lo a um produto real, seria necessário verificar comandos, regras, mensagens e resultados no ambiente adequado.

Escreva cada passo em torno de uma ação observável

Um passo útil tem um verbo e um objeto identificável. «Preencha tudo corretamente» não diz o que fazer. «Indique a data de retirada e a quantidade de kits» identifica dois dados. Eles podem ficar no mesmo passo se forem preenchidos juntos; se exigirem telas diferentes, separe-os.

As orientações de Designers Italia recomendam textos de interface específicos, contextuais e voltados para o objetivo. Use os nomes que aparecem no serviço. Chamar o botão «Enviar solicitação» de «Confirmar pedido» em outro trecho pode sugerir um resultado diferente.

Não dependa apenas de posição e cor. «Clique no botão verde à direita» pode deixar de fazer sentido após uma mudança de layout. Nomeie a ação e acrescente a posição somente quando ajudar. Uma imagem deve mostrar o passo correto e acrescentar informação ao texto.

Identifique o que falta numa explicação curta

Acesse o serviço e preencha o formulário. Ao terminar, confirme. Se houver problemas, confira os dados e tente novamente. Kits especiais podem exigir autorização. A solicitação será tratada assim que possível.

O texto parece breve, mas omite o que preparar, quando obter a autorização e como reconhecer o envio bem-sucedido. «Confirme» pode significar revisar os dados ou concluir a reserva. «Tente novamente» não distingue um erro corrigível de uma solicitação já recebida.

Reconstrua o serviço antes de reescrever. Neste caso fictício, vamos supor que os kits especiais exigem um código, que há um resumo antes do envio e que o recebimento gera um número de solicitação. São condições do exemplo de escrita, não recursos testados num produto real.

Ordene as condições, as ações e o resultado

Antes de começar, prepare a data de retirada e a quantidade. Para um kit especial, obtenha também o código de autorização do laboratório fictício. Essa condição deve aparecer antes do envio, não escondida numa observação final.

1. Acesse o serviço de reservas e abra Nova solicitação.
2. Selecione o tipo de kit e informe a quantidade e a data de retirada.
3. Se for um kit especial, preencha o campo do código de autorização.
4. Abra o resumo. Confira tipo, quantidade e data; corrija os dados antes de continuar.
5. Se os dados estiverem corretos, selecione Enviar solicitação.
6. Guarde o número exibido na confirmação de recebimento.

Recebimento não significa aprovação quando ainda existe uma análise. Num serviço real, explique como a decisão será comunicada e onde consultar se a confirmação não chegar. Verifique essas informações; não as deduza do nome do botão.

Dê a cada problema uma orientação adequada

«Algo deu errado» é insuficiente quando a pessoa pode agir. Se falta um código, indique o campo. Se ele é inválido, explique como conferi-lo ou a quem recorrer. Se o serviço está indisponível, não faz sentido pedir alterações em dados corretos.

Designers Italia recomenda explicar o problema e a solução sem culpar a pessoa. «Insira o código de autorização para solicitar este kit» ajuda mais do que «Você preencheu o formulário incorretamente», desde que o sistema realmente identifique essa causa.

Preveja também a dúvida sobre o envio. Se o número não aparecer, explique como consultar o estado antes de repetir a solicitação. «Clique novamente» não resolve todos os casos. Verifique quais ações podem ser desfeitas e quais gerariam um segundo envio.

Mostre as alternativas sem interromper todos os passos

Coloque a exceção junto ao ponto em que ela muda o procedimento. «Se solicitar um kit especial» deve vir antes do código, sem reaparecer entre parênteses em cada passo. Uma alternativa longa pode ter uma seção própria com um critério claro de escolha.

Use passos numerados para ações em sequência e marcadores para materiais sem ordem. «Depois do envio» ajuda a encontrar confirmações e prazos melhor do que títulos repetidos como «Outras informações».

A análise de legibilidade pode apoiar a revisão da linguagem, mas o índice Gulpease foi concebido para o italiano. Ele não verifica requisitos ou recursos do serviço. Mesmo frases curtas falham quando falta um documento necessário. Separe a revisão do texto do teste de execução.

Teste o percurso e registre o que acontece

Num serviço real, observe uma pessoa do público pretendido começando com as condições indicadas e tentando concluir a tarefa sem explicações adicionais. Anote os pontos de intervenção e as perguntas. Não atribua automaticamente a dificuldade à falta de atenção: pode faltar informação ou haver diferenças entre o texto e a interface.

Verifique o percurso comum e as alternativas descritas. Registre como não verificada qualquer parte que não tenha sido testada. Uma revisão textual não demonstra o envio bem-sucedido, a acessibilidade da interface ou o funcionamento de uma mensagem de recuperação.

Após mudanças no serviço, reveja rótulos, condições, imagens e resultado final. A data de revisão deve refletir verificações reais. O objetivo é reduzir as dúvidas e manter as instruções de acordo com o que o serviço permite fazer.