Professor Esp. Douglas Diego
INESUL- ANÁPOLIS
Cronograma
1 Editoração Eletrônica de Textos Técnicos, Relatórios, Formulários, Esquemas, Gráficos e Planilhas
Esquemas, Gráficos e Planilhas
2 Metodologia para Documentar e Acompanhar o Projeto
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
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,
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ção
Outro passo importante da documentação é que esteja dentro doplanejamento 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ção
A 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ção
Um 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 metadados
organização. Em um ambiente de warehouse os metadados
se 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ção
Dentro 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
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.
