Checklist Pré-Inspeção

Como parte das Diretrizes para elaboração do DR, um Checklist Pré-Inspeção foi elaborado como forma de verificar os requisitos funcionais descritos. Mesmo usando o Formato proposto e as Recomendações de Escrita, o escritor do DR deve certificar-se de que seu produto esteja numa forma que poucos ou nenhum defeito seja encontrado. O objetivo é impactar o menos possível o processo de inspeção, ou seja, exigir menos esforço e re- trabalho.

Terminada a elaboração de DR, a sua inspeção é iniciada como forma de validar aquilo que foi documentado. Porém, a atividade de inspeção com a aplicação das técnicas de leitura está associada com um alto custo, demandando tempo para a sua execução, dinheiro e emprego de pessoas com conhecimento adequado. Não valeria a pena submeter um DR para validação sem que este apresentasse um mínimo de qualidade.

Outra questão é que mesmo usando determinados checklist para inspeção, cuja aplicação requer menos esforço, também não faria sentido. Isso porque segundo Brykczynski [1999], alguns itens do checklist seriam melhores usados como critério de entrada ou saída anterior à inspeção. Seria mais eficaz caso uma única pessoa verificasse determinadas propriedades ou ações ao invés de se ter uma equipe completa de inspeção para realizar tal checagem.

Por esta razão, um Checklist Pré-Inspeção foi proposto como critério de entrada para o DR poder iniciar um processo de inspeção. O objetivo é fornecer dicas que previne certos erros freqüentes de serem cometidos e que determine quando um DR está pronto para ser submetido a um processo de inspeção. Embora sejam amplamente comentadas e diversos estudos divulguem as dificuldades de se ter um DR de boa qualidade, não foi encontrado, até o estudo desse presente trabalho, assuntos que abordem os requisitos de quando ingressar a inspeção de um DR, de que forma um DR deve se apresentar para que qualquer um não seja examinado, ou seja, de como selecionar um bom DR.

Assim, o Checklist Pré-Inspeção deve ser usado pelo próprio autor do DR, assim que este for concluído, como forma de verificar a qualidade do DR antes de prosseguir direto com a inspeção.

Além da conformidade do DR com o formato do padrão IEEE [1998], do uso do Formato para especificação de Requisitos Funcionais e Recomendações de Escrita propostas, o Checklist Pré-Inspeção exposto abaixo deve ser procedido.

Figura 5.2 Checklist Pré-Inspeção.

O checklist apresentado tenta ser menos genérico em relação aos checklists usados para inspecionar documento, pois são questionadas principalmente as ausências de certas informações que deveriam estar descritas nos Requisitos Funcionais. Tais perguntas foram baseadas nos estudos realizados usando os DRs que se encontram nos Anexos 1, 2 e 3. Esse

Checklist Pré-Inspeção dá suporte ao autor do DR ao verificar se a descrição dos Requisitos

Funcionais estão completas.

Nos checklists de inspeção de DR são muito comuns as perguntas que verificam se todas as entradas do sistema foram especificadas, se as limitações, condições e restrições 1. Mensagens que devem ser exibidas ao usuário do sistema foram definidas e para

qual finalidade (alerta, erro, sucesso, status, aviso,...)?

2. Variáveis definidas que estão relacionadas a outras são devidamente atualizadas quando a variável associada a elas se altera?

3. A partir da descrição dos requisitos funcionais é possível especificar curso normal e alternativo de um MCU?

4. Caso um requisito funcional apresente mais de uma possibilidade de saída como resposta de sua execução, tais saídas foram especificadas?

5. Os requisitos funcionais que solicitam alteração de dados especificam quais deles podem ser alterados?

6. Os requisitos funcionais que solicitam remoção, alteração e consulta a dados armazenados, os quais necessitam localizar dados, informam como será feita a busca, ou seja, a partir de qual dado as informações serão localizadas? 7. No caso em que um requisito funcional interage com outro através da solicitação

de serviço, o qual é executado por este outro requisito, os dados enviados e recebidos de um requisito e outro são coerentes?

8. Requisitos funcionais que realizam comparação (<,>,=) apresentam informações do que deve ser feito em todos os casos?

9. Requisitos funcionais que realizam verificação / checagem, por exemplo, se é válido ou inválido, se correto ou incorreto, normalmente os que permitem apenas duas possibilidades, apresentam informações do que deve ser feito em ambos os casos?

foram identificadas, se os requisitos estão não ambíguos, claros, etc. Tais checagens já foram consideradas no Formato de especificação de Requisitos Funcionais proposto e nas Recomendações de Escrita.

Através do Checklist Pré-Inspeção tenta-se minimizar a quantidade de vezes que um DR tem de retornar ao autor que o elaborou devido a erros e falta de informações.

5.3

Considerações Finais

Neste capítulo foram apresentadas as Diretrizes para elaboração de DR com ênfase em Requisitos Funcionais, as quais são compostas de um Formato para Especificação de Requisitos Funcionais, Recomendações de Escrita e Checklist Pré-Inspeção.

O conjunto de instruções que compõem as Diretrizes foi baseado nos estudos feitos em alguns DRs aplicando-se neles as técnicas de inspeção PBR-Usuário, Checklist e TUCCA e observando-se os defeitos encontrados. Dessa forma, pôde-se definir essas Diretrizes para que um DR não apresentasse esses tipos de defeitos encontrados durante a inspeção.

Com essas Diretrizes pretende-se auxiliar na definição de um DR de forma a melhorar a sua qualidade, contribuindo indiretamente para que uma possível atividade de inspeção seja mais efetiva e de forma a facilitar a aplicação da técnica TUCCA, no que diz respeito à ferramenta que está sendo construída para apoiar a aplicação dessa técnica. Tais instruções proporcionam ao autor de um DR um subsídio no momento da sua preparação, visto que não há nenhum outro documento que possa servir de apoio, pois o DR é o primeiro documento elaborado num processo de desenvolvimento de software.

Considerando-se as propriedades de qualidade que um DR deve apresentar, descrito no Capítulo 3, Seção 3.3, tem-se que as Diretrizes propostas proporciona o alcance de determinadas delas, pois seu conjunto de instruções leva à especificação de Requisitos Funcionais usando um formato mais definido, possui recomendações que auxilia na escrita de sentenças de requisitos de forma a evitar, principalmente, a ambiguidade e, por fim, um

checklist que faz uma breve verificação destes requisitos. A Tabela 5.2 mostra as propriedades

Tabela 5-2 Relação entre as Diretrizes propostas e as Propriedades de qualidade do DR. Diretrizes propostas Propriedades de Qualidade alcançada

1) Formato de um Requisito Funcional

Completo; Compreensível; Modificável; Organizado; Livre de implementação; Orientado à

cliente/usuário

2) Recomendações de Escrita

Requisitos Múltiplos Conciso

Acrônimos Completo

Termos consistentes -

Requisitos Redundantes Não redundante

Frases imperativas -

Marcador "/" Não ambíguo

Composição de lista Completo

Termos "e/ou" Não ambíguo

Palavra "qualquer" Não ambíguo

Expressão "assim como" Não ambíguo

Palavras ambíguas Não ambíguo

Sentenças pouco expressivas -

Referências explícitas Completo

3) Checklist Pré-Inspeção Completo; Correto

Seguindo as Diretrizes propostas, primeiro analisando como deve ser definido um Requisito Funcional por meio do formato, depois observando as Recomendações de Escrita e por fim conferindo os itens do Checklist Pré-Inspeção, pretende-se que o DR esteja em um formato mais apropriado para ser revisado. Um dos pontos de interesse desta linha de pesquisa é justamente criar subsídios para essa decisão.

No capítulo seguinte é relatado o estudo realizado para avaliação das Diretrizes propostas, sendo detalhada a aplicação das técnicas de inspeção PBR-Usuário, Checklist e TUCCA nos DRs antes e depois do uso das Diretrizes.