Diretrizes de escrita do Criador de Tutoriais

Número de seções, etapas e observações

Veja abaixo o número recomendado de seções e etapas que você pode usar para criar um tutorial. Mas lembre-se: quanto menos, melhor! 

Photoshop

• Seções: os melhores tutoriais têm menos do que quatro seções. Dez seções é o máximo.
• Etapas: deve haver menos do que cinco etapas por seção. Não coloque todas as etapas em uma só seção!
• Para encontrar mais instruções sobre como escrever coach marks e observações, acesse aqui. 

Illustrator

• Seções: um tutorial pode ter no máximo 10 seções
• Etapas: deve haver menos do que cinco etapas por seção, com o máximo desejado de três etapas. 
• Observações: não mais do que duas observações por etapa. 
• Você precisará visualizar o tutorial para conferir se as etapas e as observações estão visíveis no painel em cada seção (o ideal é evitar rolagem vertical).
• Para encontrar mais instruções sobre como escrever seções, etapas e observações, acesse aqui. 

Número de caracteres

Cada campo de texto no Criador de Tutoriais possui um contador para ajudar a ficar dentro dos limites de caracteres.

Escrever títulos

Títulos de tutorial

• Comunique com clareza o tema do tutorial no título.
• Crie um título pesquisável.
  • Inclua palavras que um usuário utilizaria ao pesquisar sobre o assunto. 
  • Faça uma pesquisa no Google ou use um software de SEO para encontrar as palavras mais pesquisáveis.
• Respeite o limite de caracteres do título do tutorial.
• Comece o título com um verbo de ação, não em gerúndio.
  •  Exemplo certo: faça, crie, clareie, desenhe, aprimore, melhore…
  •  Exemplo certo: clareie uma foto escura com uma camada de ajuste
  •  Exemplo errado: clareando uma foto escura com um ajuste de camada
• Evite “Instruções para” ou “Saiba como” em títulos, a menos que discutido com o gerente da comunidade.
  •  Exemplo certo: dê destaque às cores
  •  Exemplo errado: saiba como destacar cores
• Se você mencionar recursos do produto no título, inclua a finalidade do recurso.
  •  Exemplo certo: remova objetos de uma foto com a ferramenta Pincel de recuperação para manchas
  •  Exemplo certo: remova objetos pequenos de uma foto
  •  Exemplo errado: use a ferramenta Pincel de recuperação para manchas
• Crie um título curto. 
  • O máximo são 60 caracteres com espaço. Quanto menor, melhor.

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.
  • Escolhemos utilizar gerúndio em resposta à maneira como alguns usuários leem títulos de seção como etapas. Utilizar gerúndio em vez de imperativo ajuda a definir as expectativas certas. 
  • Exemplos: 
    •  Adicionando o seu próprio texto
    •  Aprimorando a aparência da ilustração
    •  Adicione seu próprio texto
    •  Aprimore a aparência da ilustração
•  Não adicione um ponto no final do título de uma seção

Escrever descrições

Descrições de tutorial

• A descrição do tutorial é exibida abaixo do título do tutorial na tela inicial. Use-a para descrever o que o tutorial aborda e por que ele é útil.
•  Adicione um ponto no final da descrição do tutorial.
•  Exemplo certo: uma foto escura pode ocultar detalhes importantes. Ilumine esses detalhes adicionando uma camada de ajuste de Brilho/Contraste e pintando sobre a máscara incluída na camada de ajuste. 

Descrições de seção

• Um descrição de seção opcional é exibida abaixo do título da seção. Você pode usá-la para oferecer contexto e “porquês” adicionais para as etapas da seção.
•  Adicione um ponto no final da descrição de uma seção.
• Descrições de seção são opcionais.
•  Exemplo certo: uma  máscara de camada permite ocultar parte de uma camada de imagem subjacente sem alterar permanentemente a camada de imagem