Professor Esp. Douglas DiegoINESUL- ANÁPOLIS

Cronograma

1Editoração Eletrônica de Textos Técnicos, Relatórios, Formulários,

Esquemas, Gráficos e PlanilhasEsquemas, Gráficos e Planilhas

2 Metodologia para Documentar e Acompanhar o Projeto

Total 30h

Importância da Documentação�Se um médico fornece a você uma prescrição

de um remédio e informa que está ocupado, não podendo incluir as instruções de não podendo incluir as instruções de quantas vezes e de qual quantidade você deverá tomar este remédio – qual seria a sua reação. Levando este raciocínio para o campo da informática, pergunta-se: Por que devemos liberar sistemas e não prover a documentação adequada?

Importância da Documentação

�A documentação é um aspecto sumamente importante, tanto em redes quanto no desenvolvimento da aplicação como na manutenção da mesma. Muita gente não manutenção da mesma. Muita gente não faz esta parte do desenvolvimento e não se dá conta de que perde a possibilidade da reutilização de parte do programa em outras aplicações, sem necessidade de conhecer o código no dedo.

Importância da Documentação

�A documentação de um programa começa com a construção do mesmo e finaliza justo antes da entrega do programa ou aplicação ao cliente. programa ou aplicação ao cliente. Mesmo assim, a documentação que se entrega ao cliente terá que coincidir com a versão final dos programas que compõem a aplicação.

Importância da Documentação

�Documentação tem sido, ao longo do tempo, o calcanhar de Aquiles de muitas organizações de Tecnologia da Informação. Tão distante para atingir Informação. Tão distante para atingir quanto para manter a documentação. O que parece ser um sonho impossível.

Importância da Documentação

�Parte do problema são, aparentemente, os intermináveis tipos de documentos que são requisitados (exemplo: plano da arquitetura da organização, instruções de trabalho, modelo conceitual, modelo lógico, modelo da organização, instruções de trabalho, modelo conceitual, modelo lógico, modelo físico, modelo implementação, documentação de programas, documentação de sistemas, documentação do usuário, documentação técnica, planos de teste, planos de treinamento, e assim por diante).

Importância da Documentação� Da perspectiva da Tecnologia da Informação, realizar a

documentação é fator crítico para o sucesso. Então, documentação é o centro dos componentes para suportar a gerência de mudança com sucesso.

Um aspecto que é colocado por alguns autores é o fato de que é Um aspecto que é colocado por alguns autores é o fato de que é necessário examinar o motivo pelo qual as organizações estão gastando bilhões de dólares com o problema do ano 2000, quando poderiam despender apenas um ou dois milhões. Pode-se dizer que a causa é a falta de uma "documentação" apropriada, ou a não existência da mesma. A documentação poderia ter diminuído o esforço e o tempo gasto para a conversão de sistema/software para o problema do ano 2000. Espera-se que no processo de conversão as organizações tenham tomado o cuidado de providenciar a documentação.

Importância da Documentação� Com a documentação escolhemos a seqüência

apropriada para desenvolver e migrar sistemas. Podemos gerenciar projetos, educar, antecipar, executar planejamento de capacidade, gerenciar expectativas, enfim, podemos nos situar nas expectativas, enfim, podemos nos situar nas mudanças.

Uma idéia a ser usada pela Tecnologia da Informação é de criar um "framework" para a documentação. Um exemplo desta técnica é o "Zachman Framework for Enterprise Architecture".

Importância da DocumentaçãoOutro passo importante da documentação é que esteja dentro do

planejamento do ciclo de desenvolvimento de sistemas da organização. O planejamento deve conter algumas etapas, como as que relacionamos a seguir:

� Criar exemplos e listá-los;� Criar exemplos e listá-los;

� Documentar procedimentos;

� Capturar telas e listá-las;

� Fazer revisão técnica e edição;

� Imprimir documentação.

Importância da DocumentaçãoA documentação deve ser também considerada quanto

ao seu conteúdo, qualidade, formato, inovação (tecnologia utilizada), rapidez de acesso, disponibilidade. E não se deve esquecer que toda disponibilidade. E não se deve esquecer que toda documentação criada deve sofrer uma atualização periódica, de acordo com as mudanças ocorridas, para que a mesma possa refletir a realidade dos fatos.

Importância da DocumentaçãoUm projeto de Data Warehouse é uma boa maneira para

iniciar a construção de sua infra-estrutura de documentação. O Warehouse descobre fontes de informações do que é importante para o negócio da organização. Em um ambiente de warehouse os metadadosorganização. Em um ambiente de warehouse os metadadosse constituem em um componente essencial, passando a gerenciar os seus dados.

O importante é que a organização tome consciência da questão de documentação em todos os seus níveis. É necessário que continue fazendo a documentação; documentando o processo; documentando seus novos sistemas.

DocumentaçãoDentro de documentação veremos:

� Editoração Eletrônica;

Relatórios, Formulários,, Esquemas, Gráficos e � Relatórios, Formulários,, Esquemas, Gráficos e Planilhas;

� Padrões de qualidade;

� Metodologia para Documentar e Acompanhar o Projeto.

Exercícios

1. Quais as vantagens de se usar documentação na empresa?

2. Quais as etapas básicas para o planejamento da documentação?

3. Quando começa a documentação de um projeto? E quando se dá sua finalização?3. Quando começa a documentação de um projeto? E quando se dá sua finalização?

4. Complete: A documentação deve ser também considerada quanto ao seu __________,

_________, _________, _________________,____________e _____________.

5. Toda documentação criada deve sofrer uma atualização periódica, comente esta afirmação.

6. Pesquise na internet o padrão ISO 27000-20006 para Informática e descreva suas características.

Bibliografia

� http://www.dotecome.com/infoimagem/infoimagem/info34/34art4.htm

� http://www.malima.com.br/article_read.asp?id=272� http://www.malima.com.br/article_read.asp?id=272

� http://metodologiadapesquisa.blogspot.com/2008/04/importncia-da-documentao.html