- Guia do usuário do TBW
- Visão geral
- Diretrizes
- Criar um tutorial
1. Número de seções, etapas e observações
Veja abaixo o número máximo de seções e etapas disponíveis para criar um tutorial. Entretanto, pesquisas revelam que, quanto menor, melhor.
Recomendações
- Seções: os melhores tutoriais têm menos do que quatro seções. No entanto, um tutorial pode ter até 10 seções.
- Etapas: deve haver menos do que cinco etapas por seção, com o número desejado de três etapas. Não coloque todas as etapas em uma só seção!
- Observações: não mais do que duas observações por etapa.
Dica: para encontrar mais instruções sobre como escrever seções, etapas e observações, acesse Criar um tutorial > Tutoriais.
Número de caracteres
Cada campo de texto no TBW tem um contador para ajudar a ficar dentro dos limites de caracteres.
Campo de texto |
Máximo de caracteres |
Quantidade de caracteres recomendada (incluindo espaços) |
Título do tutorial |
120 | 100 |
Descrição do tutorial |
150 |
125 |
| Modelo inicial | 120 | 100 |
Título da seção |
120 |
100 |
Descrição da seção |
150 |
125 |
Etapa |
200 |
170 |
Observação |
200 |
170 |
Mensagem de conclusão |
200 |
170 |
2. Títulos e descrições
Títulos de tutorial
- Comunique o tema do tutorial no título.
- Crie um título pesquisável e otimizado para SEO.
- Comece o título com um verbo de ação, não em gerúndio.
- Exemplo: Clarear uma foto escura com uma camada de ajuste
- Evite escrever “Como” ou “Saiba como” em títulos.
- Se você mencionar recursos do produto no título, inclua a finalidade do recurso.
- Exemplo: Remover objetos de uma foto com a ferramenta Pincel de recuperação para manchas
- O máximo são 120 caracteres com espaço. Quanto menor, melhor.
- Crie um título curto.
Títulos de seção
- O título da seção deve começar com um verbo em gerúndio e resumir o que os usuários finais conseguirão fazer ao seguir as etapas da seção.
- Exemplo: Aprimorando a aparência da ilustração
- O motivo de usar gerúndio em títulos de seção é porque alguns usuários costumam ler títulos de seção como etapas. Passar de um verbo no infinitivo para um verbo em gerúndio ajuda a adequar as expectativas.
- Não adicione um ponto no final do título de uma seção.
Descrições de tutorial
- Descrições de tutorial aparecem abaixo do título do tutorial na tela inicial. Use-as para descrever o que o tutorial aborda e por que ele é útil.
- Adicione um ponto no final da descrição do tutorial.
- Exemplo: Ajuste o brilho e o contraste para melhorar uma foto escura.
Descrições de seção
- Um descrição de seção é exibida abaixo do título da seção. Use este campo para esclarecer o que o usuário vai aprender na seção. Lembre-se: quanto menor, melhor.
- Adicione um ponto no final da descrição de uma seção.
- Exemplo: Uma máscara de camada permite ocultar parte de uma camada de imagem subjacente sem alterar permanentemente a camada de imagem.
3. Elementos da interface
Ao criar etapas, você provavelmente indicará uma ferramenta, um menu ou um painel específicos para ajudar o usuário a realizar a tarefa. No campo de texto, pesquise o recurso usando o símbolo “@” para encontrar e inserir a ferramenta ou o recurso relevantes.
Conforme você digita, uma lista de sugestão de ferramentas ou recursos é exibida para você selecionar. Após selecionar o recurso, o nome dele na interface é destacado do restante do texto com uma nova formatação. Isso cria um coach mark, uma caixa azul que funciona como um auxílio visual aos usuários para indicar a ferramenta ou o recurso corretos.
Se não encontrar a ferramenta ou o recurso que deseja usar, digite o nome sem o símbolo “@”. No caso de comandos de painel e de menu, use “>” para indicar o fluxo de trabalho. Use somente o nome do elemento de interface conforme exibido no produto. Essa ação não cria um coach mark.
- Exemplo: Camadas > Ações de camada > Bloquear camada
Caso não seja possível selecionar várias ferramentas e recursos pelo método “@”, informe a alguém da equipe de operações globais de aprendizado.
4. Terminologia
As tabelas abaixo contêm termos importantes que autores devem conhecer e usar.
Acrônimos
Acrônimo |
Nome |
Definição |
CCD |
Aplicativo de desktop da Creative Cloud |
O local em que versões são disponibilizadas para instalação. |
DP |
Painel Descubra |
Um painel de produtos que exibe tutoriais. |
LCM |
Módulo de conteúdo de aprendizado |
Um termo de engenharia que se refere à parte do painel Descobrir em que tutoriais de aprendizado são exibidos. |
| LCP
|
Learn Content Portal
|
Um portal no qual usuários podem gerenciar tutoriais, playlists e coleções. |
Ps |
Photoshop | Crie imagens, fotos e artes incríveis em qualquer lugar. |
| PsW | Photoshop na Web | Crie imagens, fotos e artes incríveis em qualquer lugar usando um navegador. |
| TBW | Criador de Tutoriais Online | Uma ferramenta que permite que autores criem tutoriais guiados práticos que os usuários podem acompanhar nos produtos da Adobe na Web. |
Nomes de produto
Siga estas diretrizes ao mencionar um nome de produto em um tutorial:
- Não inclua “Adobe” no nome do produto, a menos que explicitamente estabelecido na coluna “Recomendado”.
- Mencione o Photoshop somente quando for importante para esclarecer.
- Não inclua “CC” no nome do produto.
- Se for realmente necessário usar o nome do produto, limite-se aos nomes da coluna “Recomendado” abaixo.
RECOMENDADO: |
NÃO RECOMENDADO: |
Adobe Dimension |
Adobe Dimensions |
Adobe Fonts |
Fonts |
Adobe Stock |
Adobe Stock para uso pessoal |
Camera Raw |
Adobe Camera Raw ACR Photoshop Camera Raw |
Fresco |
Adobe Fresco |
Illustrator |
Adobe Illustrator |
Illustrator para iPad |
Illustrator no iPad |
Bibliotecas |
Bibliotecas da Creative Cloud |
Lightroom Classic |
Lightroom Classic CC |
Lightroom (na nuvem) |
Adobe Lightroom Photoshop Lightroom Lightroom CC |
Lightroom mobile |
Lightroom para dispositivos móveis |
Photoshop |
Adobe Photoshop |
Photoshop para iPad |
Photoshop no iPad |
Terminologia específica para tutoriais
Com base em pesquisas e terminologia preferencial, existem escolhas de palavras específicas que devem ser usadas e evitadas. Consulte a lista abaixo, além dos motivos por trás dessas preferências. Uma terminologia uniforme promove um ambiente de aprendizado coerente a todos os usuários.
| Usar | Evitar | Por quê |
Escolha Arquivo > Salvar Escolha Converter em Objeto inteligente |
Clique em Arquivo > Salvar Selecione Converter em Objeto inteligente |
O termo preferível para indicar que um usuário deve ativar um item do menu. |
Selecione a ferramenta Cortar Selecione a camada |
Escolha a ferramenta Cortar Clique na camada |
O termo preferível para indicar que um usuário deve ativar uma ferramenta, camada ou miniatura. |
Arraste o controle deslizante de opacidade Arraste a flor Arraste para criar uma seleção retangular |
Clique e arraste o controle deslizante de opacidade Clique e arraste a flor |
O termo preferível para indicar que um usuário deve arrastar um item da interface ou parte de uma imagem. |
|
A maneira preferível para abreviar teclas modificadoras e poupar espaço e caracteres nos campos de texto.
Insira mais [ + ] depois do modificador
Inclua (Mac) (Windows) para comandos exclusivos da plataforma |
|
Mova o cursor para fora dos limites |
Mova o ponteiro para fora dos limites |
Como indicar o uso do mouse. |
Barra de ferramentas |
Painel de ferramentas, Paleta de ferramentas |
Como indicar o uso da Barra de ferramentas. |
Clique no menu Modo de mesclagem (Normal) e escolha o Modo de mesclagem |
modo de mesclar, modo de mesclagem, Modo de Mesclagem |
Também é possível inserir “@” na caixa de texto para indicar um recurso ou ferramenta. No entanto, algumas ferramentas e recursos podem não estar disponíveis nesse método.
Caso necessário, use somente a primeira letra em maiúsculo para indicar uma ferramenta ou item de menu. Se não souber o nome de um recurso ou ferramenta, passe o mouse sobre o elemento na interface para conferir a grafia correta. |
|
fácil, simples | Fácil e simples podem não refletir a maneira como os usuários veem os tópicos que são novos para eles.
Demonstre empatia com o público e evite palavras como fácil e simples, a menos que sejam importantes para descrever o que está sendo ensinado (como uma técnica que é mais rápida que a alternativa).
Em vez disso, use palavras como curto, direto ou rápido. |
|
aprendizado, curso, aula, treinamento, lição, ensinamento, instrução, educação, dever de casa, exercício |
Pesquisas indicam que os usuários costumam enxergar conteúdo de tutorial como algo voltado apenas para iniciantes ou que exige muito raciocínio e dedicação.
Use maneiras amigáveis de falar sobre a atividade de aprendizado para deixar o tom mais suave. |
Illustrator Express Photoshop Photoshop na Web |
Como o conteúdo de tutorial é criado especificamente para um produto, usar os termos “Express” ou “Photoshop” no tutorial geralmente é redundante e deve ser evitado.
No entanto, se você comparar os recursos do Express e do Photoshop na Web, pode ser necessário mencioná-los. |
5. Pontuação
Use pontuação correta, como ponto-final no término de descrições, etapas e observações. Títulos podem ser escritos sem ponto-final ou outros sinais de pontuação.
Elemento do tutorial |
Precisa de ponto-final |
Título do tutorial |
Não |
Descrição do tutorial |
Sim |
Título da seção |
Não |
Descrição da seção |
Sim |
Etapa |
Sim |
Observação |
Sim |
6. Uso de maiúsculas e minúsculas
Use apenas a primeira letra em caixa alta nos elementos do tutorial, incluindo títulos, descrições e etapas.
Orientação |
Exemplos |
Use maiúscula na primeira letra do nome de um elemento de interface, mas não no tipo do elemento |
|
Siga as regras normais de maiúsculas e minúsculas para nomes de elementos de interface que contêm várias palavras |
|
