Arquivar por categoria Documentação
Modelo para documentação de requisitos simplificado
Postado por Ronneesley como Documentação em 21 de abril de 2009
No artigo anterior, mostrei um modelo para descrição de requisitos, mas na prática existem alguns problemas quanto a leitura deste tipo de documentação:
- Normalmente a cada 3 (três) requisitos descritos naquele modelo de documentação oculpa 1 (uma) página;
- O cliente não possui ou não dedica tempo para ler documentos grandes; e
- Documentações naquele modelo se tornam grandes.
Por este motivo, uma prática recomendável é fazer um modelo simplificado daquele documento, o que cria então 2 (dois) documentos de requisitos, sendo este totalmente derivado daquele documento.
Para cada tabela do modelo anterior é criada uma tabela neste documento, mas apenas com a linha “Nome do Requisito”. Veja o exemplo abaixo:
| Nome do requisito |
Desta forma, teria outro documento apenas com os nomes dos requisitos. Particularmente colocaria uma linha a mais para identificar o requisito que é a linha “Identificação do Requisito”. Desta forma o documento ficaria assim:
| Identificação do Requisito | |
| Nome do requisito |
Deste modo, o cliente poderá visualizar este documento simplificado e caso se enteresse abre o documento de requisitos detalhado procurando pelo “Identificador do Requisito”.
Modelo para documentação de requisitos
Postado por Ronneesley como Documentação em 21 de abril de 2009
Um grande problema depois de enteder o que o cliente necessita é saber documentar o conhecimento explicito adquirido. Lembrando que existem dois tipos de conhecimentos: tácito e explicito.
Documentações podem ser feitas em textos abertos sem formatações ou utilizando um modelo para documentação. Ambos os modos atendem o objetivo, entretanto utilizar um modelo possibilita o rastreamento e uma melhor organização.
Existem vários modelos para documentação de requisitos, inclusive modelos específicos para trabalhos específicos. Veja o modelo que utilizo:
| Identificação do Requisito | Valor numérico sequencial |
| Nome do Requisito | Descrição resumida de um requisito |
| Fonte Responsável pelo Requisito | Nome do interessado que fez o analista ver o requisito |
| Data | Data da conversa com o interessado, ex: 21/04/2009 13:00 |
| Local e/ou Reunião | Onde foi realizada a conversa, ex: empresa XYZ |
| Obrigatoriedade | ( ) Imprescindível ( ) Desejável |
| Classificação quanto à prioridade | ( ) Alta ( ) Baixa |
| Classificação quanto ao risco | ( ) Alto ( ) Baixo |
| Especificação do Requisito | Descrição um pouco mais aprofundada do requisito, acredito que muitas pessoas dividem esta descrição em duas colunas: ações do usuário e do sistema, mas particularmente não gosto muito |
| Dicionário de Dados | Dicionário de dados, lembra análise estruturada (Separei esta por minha conta, pois muitas pessoas descreviam na coluna acima) |
| Responsável pelo Requisito | Analista responsável pelo levantamento ou realização do requisito |
Mesmo com os modelos é necessário saber descrever requisitos. Então, não se considere um analista somente pelo fato de saber fazer uma tabela.