Aula 7 A documentação do sistema de software

Prévia do material em texto

Disciplina Online
2018.3 EAD - PROCESSOS DE DESENVOLVIMENTO DE SOFTWARE (CCT0746/3021104) 9002
Aula 7: A documentação do sistema de software 
Apresentação:
Nesta aula iremos definir o conceito de manutenção para o processo de desenvolvimento de software.
A fase de manutenção, tem como objetivo corrigir os erros que não foram detectados nas fases anteriores, propor melhorias no sistema e prover suporte do sistema que foi desenvolvido.
Nessa fase, é fundamental o acompanhamento do produto desenvolvido, para o suporte e o processo de manutenção, entrando assim em uma nova fase de analise de requisito, ou seja, a fase inicial do processo de desenvolvimento de software.
Objetivos
Conhecer as atividades de documentação, suporte e melhoria no processo de desenvolvimento de software;
Entender as necessidades de documentar as atividades, os processos e procedimentos durante o desenvolvimento de um sistema;
Analisar as diversas formas de documentação e sugestões de melhoria;
Entender a necessidade de suporte para correção de erros que possam aparecer depois da concepção do sistema.
Documentação do produto
O Manual do Usuário é um documento com formato adequado ao perfil do público que utilizará o sistema ou produto. A linguagem deve ser clara e os termos e construções devem estar de acordo com o nível cultural e técnico do usuário final.
Vejamos agora, alguns elementos que devem fazer parte dessa documentação e qual a sua finalidade.
Documentação do processo
Cronogramas
Documentação utilizada por gerentes de projetos, executivos e gerentes funcionais, para acompanhar o andamento do projeto.
 Relatórios
Documentação de acompanhamento de recursos utilizados durante o andamento do projeto
 Documentos técnicos
Descreve estratégias de como chegar ao resultado final, registram os erros, problemas e ideias que ocorrem durante o projeto, e as razões que foram utilizadas para as tomadas de decisões.
 Comunicação
Estabelece a forma de comunicação entre os membros do projeto.
 Padronização de processos
Estabelece o formato e a cadência de como o processo deve ser implementado. Essa padronização pode seguir o formato definido pela empresa, organização, ou um formato mais abrangente, como nacional ou internacional.
Veja +
Métodos ágeis e documentação de software
Documentação de software
TESTE DE CONHECIMENTO
Qual é o nome dado ao processo de manutenção do software que tem como objetivo melhorar um sistema de software, modificando sua estrutura interna, sem alterar o comportamento interno?
· Refatoração*
· Revalidação
· Separação estática
· Fatoração
· Independência física
*Refatoração (do inglês Refactoring) é o processo de modificar um sistema de software para melhorar a estrutura interna do código sem alterar seu comportamento externo
Relacione adequadamente as colunas 1 e 2, no que se refere aos conceitos inerentes a manutenção do software
Coluna 1
1. Separação estática B
2. Refatoração C
3. Manutenção A
Coluna 2
a. Visa promover a melhoria do software 
b. Leva a identificação do código onde a variável afeta a funcionalidade 
c. Modificar a estrutura interna do software 
Marque a opção que associa corretamente as colunas 1 e 2
· 1 - b; 2 - c; 3 - a; 
· 1 - a; 2 - b; 3 - c; 
· 1 - b; 2 - a; 3 - c; 
· 1 - a; 2 - c; 3 - b; 
· 1 - c; 2 - a; 3 - b;
Explicação:
Coluna 1
1. Separação estática - b. Leva a identificação do código onde a variável afeta a funcionalidade
2. Refatoração - c. Modificar a estrutura interna do software
3. Manutenção - a.Visa promover a melhoria do software 
1 - b
2 - c
3 - a
A documentação do produto adota métodos e formatos padronizados para cada família de produtos correlatos. Fazem parte da documentação do produto:
I. Manual do usuário - Documento com formato adequado ao perfil do publico que utilizará o sistema ou produto;
II. Documentação de instalação - Descrição de como instalar o sistema, plataformas de operação, pré-requisitos necessários;
III. Documentos técnicos - Descreve estratégias de como chegar ao resultado final, registram os erros, problemas e ideias que ocorrem durante o projeto, e as razões que foram utilizadas para as tomadas de decisões.
Marque a alternativa correta:
· Todas as afirmativas estão erradas
· Apenas a afirmativa I está correta
· Apenas a afirmativa II está correta
· Apenas as afirmativas II e III estão corretas
· Apenas as afirmativas I e II estão corretas
Resposta: a terceira alternativa refere-se a documentação do processo, e não do produto.
Sobre os documentos gerados no processo de desenvolvimento de sistemas, avalie as assertivas
I. O documentação do produto deve ter linguagem clara e compatível com o nível técnico do usuário do documento.
II. Fazem parte da documentação do produto, os manuais de : introdução, Instalação e referência rápida.
III. A documentação de software, como Especificação de classes, componentes e requisitos, é útil na manutenção do software
São corretas apenas as assertivas:
· I, II e III
· I e III
· II e III	
· III	
· I e II
Explicação:
I. O documentação do produto deve ter linguagem clara e compatível com o nível técnico do usuário do documento. - verdade
II. Fazem parte da documentação do produto os manuais: introdução, Instalação e referência rápida. - verdade
III. A documentação de software, como Especificação de classes, componentes e requisitos, é útil na manutenção do software - verdade
Sobre a fase de manutenção, o que NãO podemos afirmar.
· Fase estratégica para uso da documentação produzidas nas fases do processo de desenvolvimento.
· Novas funcionalidades podem ser desenvolvidas.	
· A fase de manutenção jamais terá fim
· No início da fase de manutenção encerra-se o ciclo de desenvolvimento do software
· Funcionalidades existentes podem ser alteradas
Explicação:
Novas funcionalidades podem ser desenvolvidas. - verdade
Funcionalidades existentes podem ser alteradas - verdade
Fase estratégica para uso da documentação produzidas nas fases do processo de desenvolvimento. - verdade
No início da fase de manutenção, encerra-se o ciclo de desenvolvimento do software - verdade,
A fase de manutenção jamais terá fim - FALSO, sempre tem fim.
A documentação do produto de software adota formatos padronizados para cada familia de produtos correlatos.
Qual alternativa a seguir melhor identifica a afirmativa abaixo?
"Descreve as funcionalidades do sistema, como o usuário pode utilizar, os pré-requisitos necessarios para funcionar. "
· Manual do cliente.
· Manual de introdução.
· Manual do usuário.
· Manual do gestor.
· Manual de referência.
Explicação:
A documentação de produto é um processo que adota métodos e formatos padronizados para cada família de produtos correlatos.
Conclusão:
A afirmativa "Descreve as funcionalidades do sistema, como o usuário pode utilizar, os pré-requisitos necessarios para funcionar. " corresponde a documentação manual de introdução.
Documento com formato adequado ao perfil do público que utilizará o sistema ou produto. 
Sua linguagem deve se clara e os termos e construções devem estar de acordo com o nível cultural e técnico do usuário final, mostrando como utilizar as funcionalidades do sistema. 
Trata-se da definição do:
· Manual de referência
· Manual de introdução
· Manual primário
· Manual do usuário
· Manual de instalação
Após o sistema ter sido instalado no ambiente do usuário, ou seja, entrado em produção, começa a fase de Manutenção deste sistema. Esta fase depende muito da qualidade no processo de desenvolvimento e da documentação atualizada. Um desses documentos é a Documentação para Suporte, no qual encontramos o Manual de Sistemas. Para que ele realmente dê suporte adequado para a manutenção, ele deve:
· Mostrar como o usuário usa as funcionalidades;
· Estabelecer o formato e a cadência de como o processo deve ser implementado;
· Descrever como instalar o sistema, plataformas de operação, pré-requisitos necessários;
· Descrever as partes do código fonte, requisitos necessários e arquitetura do sistema;
· Descrever estratégias de como chegar ao resultado final;