Documentação e Ajudas

Transcrição

1 Interfaces Pessoa Máquina Documentação e Ajudas Cap. 12 Manuais e Documentação 20

2 Melhor e Pior?

3 Melhor e Pior?

4 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

5 Perguntas! Qual o teclado desenhado para minimizar o movimento das mãos? A introdução de coordenadas pode ser?

6 Sumário Importância dos manuais Características e Tipos de manuais Manuais convencionais Princípios e guias para manuais Ajudas Interativas

7 01 IMPORTÂNCIA E CARACTERÍSTICAS DOS MANUAIS

8 Introdução

9 Importância dos Manuais Documentação Incompleta ou de pobre qualidade Empresas não investem nos manuais Utilizadores não a leem

10 Importância dos Manuais São parte da Interação Pessoa-Máquina Fazem parte da Experiência de Utilização

11 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

12 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

13 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

14 Guias de Estilo Conjunto de normas e convenções Garantem consistência Estilo Terminologia Organização Melhoram usabilidade do manual

15 Teste do Manual

16 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.

17 02 TIPOS DE AJUDAS E MANUAIS

18 Tipos de Manuais Tutorial Manual Utilizador Referência Referência Rápida

19 Tutoriais Módulos de ensino sequenciais Instruções passo a passo Exemplos concretos Utilizadores Principiantes

20 Manual do Utilizador Ensina a fazer as tarefas Utilizadores Intermédios Principiantes avançados Executantes competentes

21 Referência (Completa) Lista de Todas as funcionalidades Oferece procura rápida Informação sintática específica Utilizadores Peritos

22 Referência Rápida Subconjunto de funcionalidades Mais importantes / usadas Rápido de aceder e curto Recordar detalhes Utilizadores Peritos

23 Pacote de Manuais (1980 s) Permitem evolução Principiante -> Perito Quatro documentos separados Menos intimidante

24 Manual vsconhecimento 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

25 03 PRINCÍPIOS DE ESCRITA PARA MANUAIS

26 Um Bom Manual Fácil de Navegar Fácil de Aprender Fácil de Ler

27 Facilidade de Navegação Secções segundo objetivos dos utilizadores Organização centrada nas tarefas Não na arquitetura do sistema Nãonos seus menus Pormenores técnicos não são necessários

28 Índice Geral Panorâmica de alto nível Não uma lista exaustiva

29 Índice Remissivo Objetivos dos utilizadores Como procurar canais? Nomes das operações Mudar código.

30 Divisão da Informação Motivação Utilidade do sistema Conceitos O que faz e qual o resultado Procedimentos Passos a seguir para usar

31 Ordem de Complexidade Assuntos mais simples Assuntos mais complicados

32 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

33 Facilidade de Aprendizagem Usar ilustrações Dar exemplos Usar pistas visuais e espaço Separa informação Ex. Notas

34 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

35 Erros e Soluções

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

37 Uma Coluna vsduas Colunas

38 Texto vsfiguras

39 Texto vsfiguras (Figuras à parte) Desnecessárias à compreensão do texto Usadas apenas para referência Necessitam de impressão diferente (cor)

40 04 ESTUDO SOBRE MANUAIS

41 Estudo de Fossetal.(1982) Dois manuais de um Editor de Texto Manual convencional Organizado em torno das funcionalidades do sistema Linguagem técnica Notações formais Manual modificado Organizada em torno de tarefas Informação básica seguida da mais avançada Linguagem simples e menos técnica Muitos exemplos

42 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

43 Resultados do estudo Convencional Melhor desempenho Manual modificado menos 10 min Qualidade do manual pode influenciar a aprendizagem do sistema Modificado Tarefas Concluídas Minutos por Tarefa Comandos por Tarefa Pedidos de Ajuda

44 05 AJUDAS INTERATIVAS

45 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

46 Requisitos-Disponibilidade Deve estar disponível em qualquer parte Incluir sempre uma ajuda em cada ecrã principal

47 Requisitos Precisãoe Cobertura Ajuda de acordocom 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

48 Requisitos-Consistência No Conteúdo Terminologia Estilo Com Diferentes partes do sistema de ajuda Documentação em papel

49 Requisitos da Ajuda Robustez Ajuda não deve estoirar o programa Lançar noutra thread Algumas exceções podem lançar a ajuda Flexibilidade Adapta-se aocontextoe/ouàexperiênciado utilizador(ex. Pesquisa e índice) Descrição Não impedir utilizador de continuar o trabalho Lançar num ecrã à parte (mais fácil alternar)

50 Independente da aplicação

51 Orientada à Tarefa

52 Orientada à Tecnologia

53 Ajuda Contextual

54 Glossários

55 Incluída na Interface

56 Resolução de Problemas

57 FAQ

58 Pesquisa na Ajuda

59 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

60 Exemplos Usable Help (vários exemplos de Helps online) html

61 TPC Desenho para a Web Ler Cap. 13 do Livro Secções 13.1 a 13.4