V.1 DOCUMENTAÇÃO E AJUDAS

Transcrição

1 V.1 DOCUMENTAÇÃO E AJUDAS HCI, Cap. 11, Alan Dix Melhor e Pior? 2 1

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 2

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 3

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 4

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 5

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á?

7 Tipos de Manuais Manuais convencionais: Tutoriais Referência (completa) Referência Rápida Manual do Utilizador Ajudas Interactivas

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 8

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 9

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 10

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, Criar um novo, Novo, Formatar,

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 12

13 Exemplo - Índice de Capítulo Introdução Uso de ícone Nº de secções Justificação 25 Facilidade de Aprendizagem o Comecem pelos alicerces Usem ideias familiares Permite refinar o Modelo Mental 26 13

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

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 15

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 16

17 Formatação - Texto vs Figuras 1º - Figura sumariza e suporta o texto 2º - Figura introduz o texto 3º - Figura liga blocos de texto 33 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 17

18 Ex. - Aspecto da Página 35 Alternativas 36 18

19 Exemplo - Conceito Uso de figura Imagem introduz texto Formatação da: Figura Parágrafos Cabeçalho Espaços em branco 37 Exemplo - Detalhe Sequência de acções mais detalhadas Texto introduz a figura 38 19

20 Exemplo - Novo Conceito Tutorial Figura liga texto Uso de ícone e barra Formatação da figura 39 Exemplo - Directivas No Início do Manual: Ícones Exemplos Formatação da figura 40 20

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 21

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 Convencional Modificado Tarefas Concluídas Minutos por Tarefa Comandos por Tarefa Pedidos de Ajuda o Manual modificado -> melhor desempenho (menos 10 min) o A qualidade do manual pode influenciar a aprendizagem do sistema 44 22

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) Tool Tips 46 23

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 24

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 25

26 Orientada à Tecnologia 51 Ajuda Contextual 52 26

27 Glossários 53 Incluída na Interface 54 27

28 Resolução de Problemas 55 FAQ 56 28

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 29

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 Usable Help (vários exemplos de Helps online) gallery/index.html 60 30

31 Próxima Aula Dispositivos de Entrada de Dados Texto Ler Teclados, Escrita à mão, Fala Coordenadas Ratos e derivados Tabletes 3D Novos dispositivos HCI, Cap.2 (pags ), Alan Dix 61 31