Documentação e Ajudas · Qual o teclado desenhado para minimizar o ... Principiante -> Perito ......
Transcript of Documentação e Ajudas · Qual o teclado desenhado para minimizar o ... Principiante -> Perito ......
Inte
rfac
es
Pe
sso
a M
áqu
ina
Documentação e Ajudas
19
Cap. 12 – Manuais e Documentação
Melhor e Pior ?
Melhor e Pior ?
Melhor e Pior ?
Melhor e Pior ?
Resumo Aula Anterior
Multiplicidade de Dispositivos de Interação
Entrada de Texto
Introdução de coordenadas
Não existe um dispositivo “melhor”
Critérios:
Grau de adequação à tarefa
Ergonomia (RSI)
Eficiência
Perguntas!
Qual o teclado desenhado para minimizar o
movimento das mãos?
A introdução de coordenadas pode ser?
Sumário
Importância dos manuais
Características e Tipos de manuais
Manuais convencionais
Princípios e guias para manuais
Ajudas Interativas
01IMPORTÂNCIA E
CARACTERÍSTICAS DOS MANUAIS
Introdução
Importância dos Manuais
Documentação Incompleta ou
de pobre qualidade
Utilizadores não a leem
Empresas não investem nos
manuais
Importância dos Manuais
São parte da Interação Pessoa-Máquina
Fazem parte da Experiência de Utilização
Importância dos Manuais
Primeiro contacto com usabilidade do sistema
Manual fácil de usar -> Sistema 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
Características
Bom manual não substitui Má IU
Boa explicação no manual
Não reduz número de erros
Não melhora memorização
Não aumenta a eficiência
Escrita dos Manuais
Início do processo de desenvolvimento
Vários rascunhos
Escritores envolvidos no desenho da IU
Colaboração entre escritores, designers e programadores
Se difíceis de escrever
Provavelmente aplicação difícil de aprender e de usar
Guias de Estilo
Conjunto de normas e convenções
Garantem consistência
Estilo
Terminologia
Organização
Melhoram usabilidade do manual
Teste do Manual
Teste do Manual - O que se testa?
Dificuldade de leitura
Linguagem familiar?
Navegação
Fácil chegar à informação? Índices.
Compreensão
Percebe-se o que está lá? Texto, diagramas, figuras, tabelas, etc.
02TIPOS DE AJUDAS
E MANUAIS
Tipos de Manuais
Tutorial Manual Utilizador
Referência Referência Rápida
Tutoriais
Módulos de ensino sequenciais
Instruções passo a passo
Exemplos concretos
Utilizadores Principiantes
Manual do Utilizador
Ensina a fazer as tarefas
Utilizadores Intermédios
Principiantes avançados
Executantes competentes
Referência (Completa)
Lista de Todas as funcionalidades
Oferece procura rápida
Informação sintática específica
Utilizadores Peritos
Referência Rápida
Subconjunto de funcionalidades
Mais importantes / usadas
Rápido de aceder e curto
Recordar detalhes
Utilizadores Peritos
Pacote de Manuais (1980’s)
Permitem evolução
Principiante -> Perito
Quatro documentos separados
Menos intimidante
Manual vs 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
03PRINCÍPIOS DE ESCRITA PARA
MANUAIS
Um Bom Manual
Fácil de Navegar
Fácil de Aprender
Fácil de Ler
Facilidade de Navegação
Secções segundo objetivos dos utilizadores
Organização centrada nas tarefas
Não na arquitetura do sistema
Não nos seus menus
Pormenores técnicos não são necessários
Índice Geral
Panorâmica de alto nível
Não uma lista exaustiva
Índice Remissivo
Objetivos dos utilizadores
“Como procurar canais?”
Nomes das operações
“Mudar código.”
Divisão da Informação
Motivação
Utilidade do sistema
Conceitos
O que faz e qual o resultado
Procedimentos
Passos a seguir para usar
Ordem de Complexidade
Assuntos mais simples
Assuntos mais complicados
Facilidade de Aprendizagem
Usar ideias familiares
Permitem refinar modelo mental
Introduzir passo a passo a informação
Ensinar algo nas primeiras páginas
Dá confiança aos utilizadores
Usar sequência lógica
Não referir informação ainda não introduzida
Facilidade de Aprendizagem
Usar ilustrações
Dar exemplos
Usar pistas visuais e espaço
Separa informação
Ex. “Notas”
Facilidade de Aprendizagem
Descrever do geral para o específico
Utilizador pode inferir as suas conclusões
Evitar antropomorfismos
Em vez de “o sistema sabe o nº de telefone”
Usar “pode obter o nº de telefone”
Ser consistente no estilo e terminologia
Ajudas interativas + mensagens erro + IU
Usar modelo conceptual
Erros e Soluções
Facilidade de Leitura
Usar espaços em branco
Manual menos intimidante
Usar nível de escrita básico
Parágrafos, Frases e Palavras
simples e curtas
Voz ativa e sem negativas
Ordenar as instruções
cronologicamente
Evitar termos muito
especializados
H2-?
Uma Coluna vs Duas Colunas
Texto vs Figuras
Texto vs Figuras – (Figuras à parte)
Desnecessárias à compreensão do texto
Usadas apenas para referência
Necessitam de impressão diferente (cor)
04ESTUDO
SOBRE MANUAIS
Estudo de Foss et al. (1982)
Dois manuais de um Editor de Texto
Manual convencionalOrganizado em torno das funcionalidades do sistemaLinguagem técnicaNotações formais
Manual modificadoOrganizada em torno de tarefasInformação básica seguida da mais avançadaLinguagem simples e menos técnicaMuitos exemplos
Estudo
44 estudantes
22 para cada tipo de manual
Estudaram o manual (15 a 30 min)
Medidas recolhidas:
Nº de tarefas concluídas
Tempo gasto por tarefa
Nº de comandos para completar tarefa
Nº de consultas à ajuda online
Resultados do estudo
Melhor desempenho Manual modificado menos 10 min
Qualidade do manual pode influenciar a aprendizagem do sistema
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
05AJUDAS
INTERATIVAS
Ajudas Interativas
Não se perdem nem se estragam
Não ocupam espaço físico
Atualização mais rápida e barata
Mais fáceis de consultar
Mecanismo de pesquisa
Pode-se controlar nível de detalhe
Requisitos - Disponibilidade
Deve estar disponível em qualquer parte
Incluir sempre uma ajuda em cada ecrã principal
Requisitos – Precisão e Cobertura
Ajuda de acordo com a versão do programa
Aplicação V1.2 vs Ajuda V1.1
Cobre o comportamento actual do sistema
Garantir completude da ajuda
Comandos e as tarefas mais comuns
Requisitos - Consistência
No
Conteúdo
Terminologia
Estilo
Com
Diferentes partes do sistema de ajuda
Documentação em papel
Requisitos da Ajuda
RobustezAjuda não deve estoirar o programa
Lançar noutra thread
Algumas exceções podem lançar a ajuda
FlexibilidadeAdapta-se ao contexto e/ou à experiência do
utilizador (ex. Pesquisa e índice)
DescriçãoNão impedir utilizador de continuar o trabalho
Lançar num ecrã à parte (mais fácil alternar)
“Independente” da aplicação
Orientada à Tarefa
Orientada à Tecnologia
Ajuda Contextual
Glossários
Incluída na Interface
Resolução de Problemas
FAQ
Pesquisa na Ajuda
Resumo
Manuais convencionais
Ajudas Interativas
Princípios e guias para manuais
Navegação
Aprendizagem
Leitura
Tipo de manual vs público alvo
Consistência entre IU, manuais e ajudas interativas
Modelo conceptual
Exemplos
Usable Help (vários exemplos de Helps online)
http://www.g2meyer.com/usablehelp/gallery/index.html
TPC – Desenho para a Web
Ler Cap. 13 do Livro
Secções 13.1 a 13.4