melhor e pior - fenix.tecnico.ulisboa.pt · ... vantagens e desvantagens princípios de navegação...
TRANSCRIPT
V.1 – Documentação e Ajudas
2
Resumo Aula Anterior
Tipos de diálogo
Menus, Formulários, LC e MD
Principais características, vantagens e
desvantagens
Princípios de navegação
Menus = WWW
Novos paradigmas de interacção
Sumário
Importância, características e guia de
estilos dos manuais
Manuais convencionais
Princípios e guias para manuais
Ajudas Interactivas 4
V.1 – Documentação e Ajudas
3
Importância dos Manuais
São parte da Interface Pessoa Máquina (Experiência de Utilização)
Primeiro contacto com a usabilidade do programa Se o manual é fácil de usar o programa também
será...
Influencia a compra do programa Manual de boa qualidade leva à compra
Ajuda a refinar o Modelo Mental Boa percepção de como usar o sistema 5
Características de um Bom Manual
Um Bom manual não substitui uma Má IU
Uma Boa explicação no manual Não reduz número de erros
Nem melhora a memorização das operações
6
V.1 – Documentação e Ajudas
4
Características de um Bom Manual
Um Bom manual não substitui uma Má IU
Uma Boa explicação no manual Não reduz número de erros
Nem melhora a memorização das operações
Devem começar a ser escritos no início do processo de desenvolvimento Vários rascunhos
Escritores envolvidos no desenho da IU
7
Características de um Bom Manual
Um Bom manual não substitui uma Má IU
Uma Boa explicação no manual Não reduz número de erros
Nem melhora a memorização das operações
Devem começar a ser escritos no início do processo de desenvolvimento Vários rascunhos
Escritores envolvidos no desenho da IU
Se difíceis de escrever Provavelmente aplicação difícil de aprender e de
usar 8
V.1 – Documentação e Ajudas
5
Guia de Estilo
Conjunto de normas e convenções que garantem a consistência Do estilo Da terminologia e Da organização
entre manuais de uma aplicação ou de uma família de aplicações (ex. Office)
Melhoram a usabilidade do manual ! (Tal como no caso das IUs)
9
Teste
O teste de um manual é um bom piloto para o teste da IPM
Se é difícil perceber o manual, talvez não seja apenas um problema deste, mas também da IU
10
V.1 – Documentação e Ajudas
6
Testes ao Manual
O que se testa?
Dificuldade de leitura
Navegação é fácil chegar à informação?
Compreensão percebe-se o que lá está ?
11
12 12
V.1 – Documentação e Ajudas
7
Tipos de Manuais
Manuais convencionais:
Tutoriais
Referência (completa)
Referência Rápida
Manual do Utilizador
Ajudas Interactivas
13
14
V.1 – Documentação e Ajudas
8
Manuais vs Utilizadores
o Tutoriais -> Noviços
Módulos de ensino sequenciais
o Referência -> Peritos
Procura rápida de informação sintáctica específica
o Referência Rápida -> Peritos
Subconjunto das funcionalidades mais
importantes e mais usadas (um cartão)
o Manual do Utilizador -> Intermédios
Ensina a fazer tarefas no sistema
15
Níveis de Conhecimento
Tipo Tarefa Aplicação (geral)
Sistema (específico)
Tutoriais Baixo Baixo Baixo
Utilizador Alto Baixo Baixo
Referência Alto Alto Baixo
Referência Rápida
Alto Alto Alto
16
V.1 – Documentação e Ajudas
9
17 17
Pacote de Manuais (1980´s)
4 tipos de manuais com o sistema
Tutorial, Utilizador, Referência e Referência
rápida
Permite evolução de Noviço -> Perito
Fazer quatro documentos separados (menos
intimidante)
+ Brochura que descreve o contexto em
que cada manual deve ser usado
18
V.1 – Documentação e Ajudas
10
Manual do Utilizador
Deve ser Fácil de Navegar
de Aprender
de Ler
A Formatação ajuda!
19
Facilidade de Navegação (1/2)
Organizem o nome dos capítulos e secções segundo os objectivos dos utilizadores
Enquadramento e Objectivos (Sim)
Arquitectura do Sistema (Não!)
Utilizadores não precisam de saber pormenores técnicos para encontrar o que interessa
20
V.1 – Documentação e Ajudas
11
Navegação - Índice
Índice deve fornecer uma panorâmica de alto nível e não uma lista exaustiva (é a primeira informação que se lê).
21
Navegação - Índice
Forneçam referências no índice
Orientadas aos objectivos dos utilizadores (como faço para imprimir?)
Com os nomes das operações (onde está o comando x?)
Utilizador Nome do Comando Documentos Formatar, 334-335
Criar um novo, 14-16 Novo, 14-16 Formatar, 334-335
22
V.1 – Documentação e Ajudas
12
Navegação
Separem os vários tipos de informação
Usem codificação visual consistente para cada tipo
Motivação – utilidade do programa (para quê?)
Conceitos – o que faz e qual o resultado final
Procedimentos – passos a seguir para usar
Exemplos 23
Lista de Conteúdo - Navegação (Exemplo)
Formatação
Objectivos do utilizador
Não técnico
Nº de Níveis
Espaços em branco
24
V.1 – Documentação e Ajudas
13
25
Exemplo - Índice de Capítulo
Introdução
Uso de ícone
Nº de secções
Justificação
Facilidade de Aprendizagem
o Comecem pelos alicerces Usem ideias familiares Permite refinar o Modelo Mental
26
V.1 – Documentação e Ajudas
14
Facilidade de Aprendizagem
o Forneçam os alicerces (usar ideias familiares)
o Introduzam passo a passo unidades de informação pequenas e independentes Ensinem a fazer algo nas primeiras páginas!
27
Facilidade de Aprendizagem
o Comecem pelos alicerces
o Ensinem a fazer algo nas primeiras páginas
o Usem uma sequência lógica
Não referenciem informação ainda não introduzida!
Dêem informação mínima necessária para executar uma tarefa simples.
28
V.1 – Documentação e Ajudas
15
Facilidade de Aprendizagem
o Dêem exemplos
o Apresentem ilustrações (facilitam a explicação)
o Utilizem espaço e indícios visuais
(cor, tipos, símbolos, etc., para separar info.)
o Evitem notações abstractas e formais
(Exemplos são melhores)
29
Facilidade de Aprendizagem
Levem o leitor a inferir (Geral -> Específico)
Evitem antropomorfismos (“o computador sabe o nº de TM” -> “pode obter
o nº de TM”)
Listem situações de erro e soluções (FAQ)
Sejam consistentes no estilo e terminologia
Ajudas Interactivas + mensagens de erro +
componentes de diálogo
30
V.1 – Documentação e Ajudas
16
Facilidade de Leitura
Usem espaços em branco
zonas sem informação – manual menos
intimidante
Usem um nível de escrita básico:
Parágrafos, Frases e Palavras simples e curtas
Voz activa e sem negativas
Ordenar as instruções cronologicamente
Não hifenizar nem justificar à direita
Evitem termos muito especializados 31
Formatação - Colunas
Uma coluna: Facilidade de produção Preferido por leitores de documentos
técnicos Suporta imagens maiores
Múltiplas colunas: Maior flexibilidade na colocação das
figuras Linhas mais pequenas melhora a
legibilidade do texto 32
V.1 – Documentação e Ajudas
17
Formatação - Texto vs Figuras
33
2º - Figura introduz o texto
3º - Figura liga blocos de texto
1º - Figura sumariza e suporta o texto
Formatação - Texto vs Figuras
Figuras à parte
Figuras desnecessárias à compreensão do texto
Figuras como referência
Figuras necessitam de processo de impressão diferentes (cor)
34
V.1 – Documentação e Ajudas
19
37
Exemplo - Conceito
Uso de figura
Imagem introduz texto
Formatação da:
Figura
Parágrafos
Cabeçalho
Espaços em branco
38
Exemplo - Detalhe
Sequência de acções mais detalhadas
Texto introduz a figura
V.1 – Documentação e Ajudas
20
39
Exemplo - Novo Conceito
Tutorial
Figura liga texto
Uso de ícone e barra
Formatação da figura
Exemplo - Directivas
No Início do Manual:
Ícones
Exemplos
Formatação da figura
40
V.1 – Documentação e Ajudas
21
Exemplo - Directivas
Exemplos
Caixa nas figuras
Uso de ícones
Figuras suportam texto
41
Estudo de Foss et al 82
o Comparou dois manuais de Editor de Texto Manual convencional • Organizado em torno das funcionalidades do
sistema • Usando linguagem técnica • Usando notações formais
Manual modificado • Informação organizada em torno de tarefas • Informação básica seguida de info mais
avançada • Linguagem simples e menos técnica • Muitos exemplos
42
V.1 – Documentação e Ajudas
22
Estudo
o 44 estudantes (22+22)
o Estudaram o manual (15 a 30 min)
o Dados recolhidos:
Nº de tarefas concluídas
Tempo gasto por tarefa (média)
Nº de comandos para completar tarefa (média)
Nº de consultas à ajuda online
43
Resultados do estudo
o Manual modificado -> melhor desempenho (menos 10 min)
o A qualidade do manual pode influenciar a aprendizagem do sistema
44
Convencional Modificado
Tarefas Concluídas 7.36 8.77
Minutos por Tarefa 26.63 16.00
Comandos por Tarefa 23.63 13.04
Pedidos de Ajuda 5.50 2.55
V.1 – Documentação e Ajudas
23
Ajudas Interactivas
Não se perdem nem se estragam
Não ocupam espaço físico
Actualização mais rápida e barata
Mais fáceis de consultar (mecanismo de pesquisa)
Suportam ensino interactivo
Pode-se controlar nível de detalhe
45
Requisitos
Disponibilidade Deve estar disponível em qualquer parte
(incluir sempre uma ajuda em cada ecrã principal)
46
Tool Tips
V.1 – Documentação e Ajudas
24
Requisitos
Precisão e Cobertura Está de acordo com a versão do programa e
cobre o comportamento actual do sistema App V1.2 vs Manual V1.1
Descreve os comandos, assim como as tarefas mais comuns
47
Requisitos
Consistência
No conteúdo, terminologia e estilo
Entre as diferentes partes do sistema de ajuda e a documentação em papel
48
V.1 – Documentação e Ajudas
25
Requisitos da Ajuda
Ser Robusta A ajuda não deve estoirar o programa (lançar
noutra thread)
Algumas excepções podem lançar ajuda
Ser Flexível Adapta-se ao contexto e/ou à experiência do
utilizador (ex. Pesquisa e índice)
Ser Discreta Não impede o utilizador de continuar o trabalho
(MS clip)
Lançar num ecrã à parte (mais fácil alternar) 49
Orientada à Tarefa
50
V.1 – Documentação e Ajudas
29
Pesquisa na Ajuda
57
Conclusões
Manuais convencionais e Ajudas Interactivas
Princípios e guias para manuais
Importante caracterizar o tipo de manual, a sua função e o público alvo
Garantir consistência entre IU, manuais e ajudas interactivas (modelo conceptual)
58
V.1 – Documentação e Ajudas
30
Conclusões
Desafio: suportar todas as necessidades de documentação:
Noviços -> o “como” e o “quê”
Utilizadores regulares -> relembrar procedimentos
Peritos -> procedimentos mais eficientes
59
Exemplos
Online help - Discussion articles http://deyalexander.com/resources/online-
help.html
Usable Help (vários exemplos de Helps online)
http://www.g2meyer.com/usablehelp/gallery/index.html
60