Melhor e Pior - fenix.tecnico.ulisboa.pt · ... vantagens e desvantagens Princípios de navegação...

31
V.1 – Documentação e Ajudas 1 V.1 – DOCUMENTAÇÃO E AJUDAS HCI, Cap. 11, Alan Dix Melhor e Pior ? 2

Transcript of Melhor e Pior - fenix.tecnico.ulisboa.pt · ... vantagens e desvantagens Princípios de navegação...

V.1 – Documentação e Ajudas

1

V.1 – DOCUMENTAÇÃO E AJUDAS

HCI, Cap. 11, Alan Dix

Melhor e Pior ?

2

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

18

Ex. - Aspecto da Página

35

Alternativas

36

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

26

Orientada à Tecnologia

51

Ajuda Contextual

52

V.1 – Documentação e Ajudas

27

Glossários

53

Incluída na Interface

54

V.1 – Documentação e Ajudas

28

Resolução de Problemas

55

FAQ

56

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

V.1 – Documentação e Ajudas

31

Próxima Aula

Dispositivos de Entrada de Dados Texto

Teclados, Escrita à mão, Fala

Coordenadas Ratos e derivados Tabletes 3D

Novos dispositivos

Ler HCI, Cap.2 (pags. 59-97), Alan Dix

61