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