Manual do usurio e Documentao tcnica

Thompson S

MANUAL DO USURIO: como utilizar o software?

Documento que contm informaes sobre usabilidade: recursos disponveis ao usurio; como otimizar o uso; apresentao da interface do software. Guia de referncias contendo informaes necessrias utilizao do software.

DOCUMENTAO TCNICA: como so os procedimentos de clculo?

Informaes sobre as contas Abordagem da teoria em que se fundou o especificador para a implementao do software. Definio de Conceitos Envolvidos na Modelagem Matemtica

FINALIDADE DOS MANUAIS QUANTO AO TIPO DE USURIO

DOCUMENTAO TCNICA: MANUAL DO USURIO: Desenvolvedores e pessoal envolvido com projetos similares. Tambm ao usurio que deseja obter conhecimento mais aprofundado acerca do software. Usurio comum, interessado apenas em obter algum resultado com o software.

COMO FAZER UMA BOA DOCUMENTAO?

-Planejar o documento -Verificar seus objetivos e suas funcionalidades (geralmente o especificador j sabe disso) -Resgatar boas prticas em manuais j consolidados -Criar a estrutura -Definio dos tpicos que sero abordados na documentao -Devem respeitar a hierarquia de compreenso do software -Desenvolver -Revisar -Ideal que outro componente da equipe revise

Referncias

http://pt.wikipedia.org/wiki/Usabilidade