Uma folha dobrada em 3, por cima do aparelho, com 6 desenhos e quase nenhuma palavra. Embaixo da bandeja, um caderno grampeado com dezenas de páginas, avisos de segurança e uma tabela de especificações. Os 2 papéis vêm na mesma caixa e fazem trabalhos diferentes.
O manual de instruções de produto é o documento que ensina a montar, usar, cuidar e resolver problemas ao longo da vida do objeto. O guia rápido é o recorte do manual que leva o cliente da caixa fechada ao primeiro uso. Desenhar os 2 bem é decidir o que vai em cada um, em que ordem, com que desenhos e com que sinais.
Este artigo trata da organização do conteúdo, da ilustração, dos pictogramas e do teste do material impresso que vai na caixa. O ponto de partida é simples: o manual precisa usar a mesma linguagem do objeto e da tela, porque o cliente lê os 3 ao mesmo tempo.
O tema é um dos assuntos da frente de produto e embalagem, que pertence à seção de design industrial. Quem projeta o objeto é o escritório de design industrial; a Trilion desenha o material impresso a partir das decisões desse escritório, da engenharia e da assistência técnica.
Manual e guia rápido não são o mesmo documento
O manual cobre a vida inteira do produto; o guia rápido cobre só o caminho até o primeiro uso, e por isso deve ser curto, visual e posto em cima de tudo.
O que o manual cobre
O verbete sobre guias de usuário da Wikipédia lista o conteúdo típico de um manual: instruções de segurança, montagem, instalação, configuração, operação normal, manutenção, solução de problemas, endereços de assistência, conformidade com regulamentos, especificações técnicas e garantia. É um documento de consulta, aberto muitas vezes ao longo dos anos, e quase nunca lido de ponta a ponta.
Por que existe o guia rápido
O mesmo verbete registra que, com produtos mais complexos, os manuais ficaram grandes a ponto de exigir um guia de início rápido separado. O guia rápido responde a uma pergunta só: o que fazer agora, com a caixa aberta na frente. Tudo o que não serve a esse momento fica no manual.
Papel, tela e o próprio objeto
O cliente aprende com 3 fontes ao mesmo tempo: o que está impresso, o que aparece no visor ou no aplicativo e o que está gravado no corpo do produto. Quando os 3 usam palavras e sinais diferentes para a mesma ação, a dúvida vira ligação para o atendimento. Por isso o manual entra no cronograma junto com as telas e com a gravação do produto, e não depois.
O que diz a norma IEC/IEEE 82079-1?
A IEC/IEEE 82079-1 reúne princípios gerais e requisitos detalhados para o desenho e a redação de todo tipo de instrução de uso, e é a referência internacional para quem prepara manuais.
O escopo da norma
A edição de 2019 tem o título de preparação de informação para uso, parte 1, princípios e requisitos gerais. Segundo a página da norma no catálogo do instituto sueco de normalização, ela traz princípios gerais e requisitos detalhados para o desenho e a formulação de todos os tipos de instruções de uso. A mesma página informa que ela se destina principalmente aos comitês técnicos que preparam normas de produto.
O que isso muda para quem desenha
Na prática, a norma serve de base para as exigências específicas de cada tipo de produto. Uma empresa que vai vender em vários países costuma ouvir falar dela pela área de qualidade ou pelo jurídico. Vale perguntar cedo se algum regulamento ou cliente exige conformidade com ela ou com uma norma de produto que a cite. No Brasil, as normas técnicas são publicadas pela ABNT, e a área de qualidade indica quais se aplicam.
O que a norma não resolve
Uma norma diz o que precisa estar no documento e com que cuidado. Ela não escolhe a ordem das páginas, o estilo dos desenhos nem a voz do texto. Essas decisões continuam sendo de design, e é nelas que o manual se aproxima ou se afasta da marca.
Como organizar o conteúdo pela tarefa
O conteúdo deve ser organizado pelo que o cliente quer fazer, e não pela estrutura interna do produto ou pelos departamentos da empresa.
Começar pela tarefa
O Nielsen Norman Group, nas orientações sobre ajuda e documentação, recomenda escrever do ponto de vista do usuário e ligar cada conteúdo ao que ele tenta realizar. Para um manual, isso significa trocar capítulos como "componentes" e "especificações" por títulos como "montar o suporte", "ligar pela primeira vez" e "limpar o filtro". As especificações continuam lá, mas no fim.
Visão geral no topo, detalhe depois
A mesma fonte sugere dividir o conteúdo em blocos, usar títulos claros, destacar palavras-chave e começar por uma visão geral, deixando o detalhe para depois. No papel, isso se traduz em uma página de abertura com o mapa do documento e em capítulos curtos, cada um com um título que diz a tarefa.
Passos concretos e numerados
Instrução vaga não ajuda. O Nielsen Norman Group pede passos específicos, em lista numerada, em vez de descrições gerais. Cada passo deve ter uma ação, e o resultado esperado deve aparecer logo depois: o que o cliente vai ver, ouvir ou sentir quando acertar.
Uma ordem que funciona para muitos guias rápidos:
- Conferir o conteúdo da caixa, com desenho de cada peça.
- Retirar travas, películas e proteções de transporte.
- Montar ou posicionar o produto.
- Ligar à energia e, se houver, ao aplicativo.
- Fazer o primeiro uso completo, com o resultado esperado.
- Indicar onde está o manual e como falar com a assistência.
Como o cliente encontra o que procura
Na tela, encontrar é buscar. No papel, encontrar depende de sumário, de títulos visíveis na margem, de cor por capítulo e de um índice no fim. Um capítulo de solução de problemas organizado pelo sintoma, e não pela causa, poupa tempo: o cliente sabe o que está vendo, não o que quebrou.
Ilustração: desenhar o que a mão faz
A ilustração de manual mostra a ação do ponto de vista de quem executa, com uma ação por desenho e um estilo único do começo ao fim do documento.
Diagrama simplificado
O verbete da Wikipédia observa que manuais de equipamentos usam diagramas simplificados, enquanto guias de software usam capturas de tela. O diagrama simplificado tira textura, sombra e detalhe que não importam para a tarefa. Sobra a forma, a peça em foco e a seta que indica o movimento.
Uma ação por desenho
Desenhos que mostram 3 movimentos ao mesmo tempo obrigam o cliente a adivinhar a ordem. Separe as ações, numere os desenhos com o mesmo número do passo escrito e mantenha a peça na mesma posição entre um desenho e o seguinte, para que a mudança fique evidente.
Estilo coerente com o objeto
Espessura de linha, ângulo de vista, cor de destaque e forma das setas formam um pequeno sistema. Esse sistema deve conversar com a linguagem do produto e com as telas. Os critérios para manter essa coerência estão na frente de linguagem de produto e marca.
- Vista: a mesma perspectiva em todo o documento, de preferência a de quem está diante do produto.
- Linha: 1 espessura para contorno e outra para a peça em foco.
- Cor: 1 cor de destaque, usada só para o que se mexe ou se aperta.
- Setas: 1 desenho de seta para movimento e outro para encaixe ou clique.
- Mãos: desenhadas só quando a pegada importa para o passo.
Pictogramas: o mesmo sinal no objeto, na tela e no papel
Os pictogramas do manual devem ser os mesmos gravados no produto e exibidos na tela, sempre acompanhados de texto, porque poucos ícones são entendidos sem rótulo.
Poucos ícones são universais
O Nielsen Norman Group lembra que só alguns ícones têm reconhecimento quase universal, como casa, impressão e busca. A maioria é ambígua, e o mesmo desenho muda de sentido de uma interface para outra. Em um manual, isso pede cuidado com sinais criados para o produto: o cliente nunca os viu antes.
Rótulo ao lado do sinal
A mesma fonte recomenda que um rótulo de texto acompanhe o ícone para esclarecer o significado naquele contexto. No papel, não há passar o cursor por cima para descobrir. O pictograma do botão aparece no desenho, e o nome do botão aparece ao lado, com a mesma grafia usada na tela.
Consistência
Usar o mesmo ícone para funções diferentes confunde, e pequenas variações de sentido quebram a confiança do usuário. A regra vale entre os 3 meios: o sinal de limpeza gravado na tampa, o da tela e o do manual são um desenho só. O ofício de desenhar esses sinais está na seção de ícones e símbolos.
Quando o sinal da tampa, o da tela e o do papel são o mesmo, o cliente aprende 1 vez e reconhece 3.
Linguagem, avisos e idiomas
O texto do manual usa as palavras do cliente, explica o termo técnico quando ele é inevitável e põe o aviso de segurança antes do passo a que se refere.
Jargão mínimo
O verbete da Wikipédia anota que a linguagem do guia deve servir ao público pretendido, com jargão reduzido ao mínimo ou explicado por inteiro. Um termo de engenharia que faz sentido na fábrica pode não fazer sentido na cozinha ou no almoxarifado. Uma lista de termos aprovados, compartilhada com quem escreve as telas, evita que o mesmo comando tenha 2 nomes.
Aviso antes do passo
Aviso de segurança no fim do capítulo chega tarde. Ele entra imediatamente antes da ação de risco, com destaque visual próprio e com o mesmo formato em todo o documento. Os textos de segurança costumam vir da engenharia e do jurídico; o design organiza a forma e a posição.
Vários idiomas na mesma caixa
Produtos vendidos em vários países levam manuais em vários idiomas. Desenhos sem texto embutido podem ser compartilhados entre as versões, e o texto fica em blocos separados. Vale prever desde o início que algumas línguas ocupam mais espaço do que outras, para que a página não se desmanche na tradução.
Como testar o manual antes de imprimir
O manual se testa com pessoas que nunca viram o produto, seguindo o guia rápido com a caixa fechada na frente e sem ajuda de quem o escreveu.
O teste com a caixa fechada
Entregue a caixa a 3 ou 4 pessoas do público do produto e peça que cheguem ao primeiro uso. Observe onde param, o que releem e o que fazem fora da ordem. Cada hesitação aponta um desenho ou uma frase a revisar. Os métodos para esse tipo de observação estão na seção de UX e UI.
Lista de verificação antes da gráfica
- Cada passo do guia rápido tem 1 ação e 1 desenho.
- Os nomes de botões e funções são os mesmos da tela.
- Os pictogramas são os mesmos gravados no produto.
- Todo aviso de segurança vem antes do passo de risco.
- O capítulo de problemas está organizado pelo sintoma.
- O documento foi revisado com a amostra final do produto.
- Assistência técnica e jurídico aprovaram os textos que lhes cabem.
A amostra certa
Um manual revisado com um protótipo antigo pode descrever um botão que mudou de lugar. A última revisão deve ser feita com a amostra fiel do produto e com a versão final das telas. Se o produto mudar depois disso, o manual também muda, e entra de novo na lista de verificação.
O que levar para o briefing do manual
Leve a amostra do produto, as telas, a lista de avisos obrigatórios e os idiomas de venda: com isso, o manual pode nascer junto com o objeto e falar a mesma língua dele.
O essencial deste artigo
Manual e guia rápido fazem trabalhos diferentes. O conteúdo se organiza pela tarefa, com passos numerados e concretos. A ilustração mostra uma ação por desenho, em estilo único. Os pictogramas são os mesmos do objeto e da tela, sempre com rótulo. E o documento é testado com quem nunca viu o produto.
O próximo passo
O guia rápido é a primeira camada da abertura, e a ordem dessa abertura é tratada na página de produto e embalagem, onde você monta o briefing. Para a caixa que vai pela internet, veja o artigo sobre embalagem para venda on-line de equipamentos. O cuidado com a diagramação de documentos longos aparece também na seção de design editorial.
Sobre este texto
Artigo do hub de Design da Trilion. Cada fato citado foi conferido nas páginas a seguir, abertas em 17/11/2026. A ordem sugerida para o guia rápido, os critérios de ilustração e a lista de verificação são leitura editorial. O texto não substitui a leitura da norma completa nem a orientação das áreas de qualidade e jurídica da empresa.
- SIS, IEC/IEEE 82079-1:2019 (consulta em 17/11/2026)
- Nielsen Norman Group, Help and Documentation (consulta em 17/11/2026)
- Nielsen Norman Group, Icon Usability (consulta em 17/11/2026)
- Wikipedia, User guide (consulta em 17/11/2026)
Fontes consultadas
- SIS: IEC/IEEE 82079-1:2019 (consulta em 17/11/2026)
- Nielsen Norman Group: Help and Documentation (consulta em 17/11/2026)
- Nielsen Norman Group: Icon Usability (consulta em 17/11/2026)
- Wikipedia: User guide (consulta em 17/11/2026)

