[Ai] Escrever seções, etapas e observações

Deixe sua voz e estilo em evidência ao escrever seu tutorial. Evite linguagem que possa parecer promocional ou desnecessária.

Orientações para escrever seções, etapas e observações

Todos os tutoriais criados no Criador de Tutoriais do Illustrator são formados por seções, etapas e observações. Cabe a você determinar como organizar o conteúdo para que o tutorial fique dividido em pedaços menores chamados de seções. 

Cada seção contém uma série de etapas e, às vezes, observações. A recomendação é evitar continuar etapas de uma seção para outra (a menos que a seção precise continuar). Todas as etapas são numeradas. Uma observação não é numerada, pois contém informações auxiliares de uma etapa numerada. 

Algumas informações deverão ser inseridas manualmente em vez de gravadas. Sempre use a opção Posicionamento > Tela para adicionar uma etapa numerada manualmente. 

Ao escrever etapas, lembre-se de editar para deixar o texto mais claro e conciso. É melhor evitar que o usuário use a rolagem para ler todas as etapas em uma seção. Além disso, blocos de texto grandes cansam os usuários. Edite para manter os usuários interessados e seguindo o tutorial. 

Exemplo: se estiver criando um tutorial sobre como trabalhar com formas no AI, as seções podem ser: 

• Criar uma forma
• Editar a forma
• Arredondamento dos cantos
• Adicionar outras formas
• Montar o _______
• Combinação de formas

Comece cada etapa com um verbo de ação que diga aos usuários o que fazer

• Exemplo certo: clique no ícone de mais para adicionar à seleção.
• Exemplo errado: caso a ferramenta não tenha selecionado o objeto inteiro, clique no ícone de mais para adicionar à seleção.

Inclua valores aproximados nas etapas

• Inclua um valor aproximado para cada controle deslizante ou campo numérico que o usuário precisar alterar
• Exemplo certo: arraste o controle deslizante de claridade para cerca de +20 para aumentar o contraste nos tons médios.

Inclua o “porquê” nas etapas

• Tipos de “porquês” para incluir:
  • O resultado de uma instrução 
  • Motivos para usar determinado fluxo de trabalho ou ferramenta
• Exemplos:
  • Resultado da instrução:
    • Exemplo certo: arraste o controle deslizante de opacidade para cerca de 80 para deixar a ilustração mais transparente.
    • Exemplo certo: aumente o tamanho do pincel para cerca de 50 para deixá-lo um pouco maior que a área
    • Exemplo errado: arraste o controle deslizante de opacidade para cerca de 80.
  • Motivos para usar determinado fluxo de trabalho ou ferramenta:
    • Exemplo certo: arraste uma caixa de texto para criar texto de parágrafo. Texto de parágrafo, cujo fluxo é reorganizado dentro da caixa, é útil quando há muito texto para adicionar.

Use observações para acomodar alguns dos porquês

• Se uma etapa não tiver espaço para um “porquê” específico, considere inserir uma observação em sequência detalhando o porquê sem incluir uma ação. Entretanto, use observações com moderação, pois o usuário deve se concentrar em clicar para avançar sem interrupções.
  • Exemplo certo:
    • Etapa: clique no ícone Localizar objeto no painel Camadas.
    • Observação: o conteúdo selecionado no documento aparece no painel Camadas.
• Não inclua sugestões de fluxos de trabalho alternativos, principalmente em tutoriais para iniciantes.
  • Exemplo errado: outra maneira de adicionar uma camada de ajuste é acessando o painel Ajustes e clicando no ícone de camada de ajuste.