Verificação do artefato "Léxicos"
Introdução
A verificação de artefatos desempenha um papel crucial na avaliação de documentos, projetos ou produtos em diversas áreas, incluindo os Requisitos de Software. Essa técnica visa a análise minuciosa do conteúdo, estrutura e características específicas de um artefato, com o propósito de avaliar sua qualidade, conformidade com requisitos e adequação aos objetivos estabelecidos. Neste contexto, este documento tem como objetivo executar esse procedimento no artefato Léxicos [3] , desenvolvido pelo Grupo 6.
Em termos práticos, a técnica de verificação, inspirada no processo de Fagan, implica na análise rigorosa e sistemática do artefato em busca de erros, inconsistências, lacunas e desvios em relação aos requisitos. Essa etapa é fundamental para assegurar a qualidade e precisão do artefato, garantindo que este esteja alinhado com os objetivos do projeto ou documento em questão.
Metodologia
A metodologia adotada para a verificação dos artefatos é composta por duas abordagens distintas, cada uma contribuindo para assegurar a qualidade e integridade do material analisado.
A primeira é fundamentada nos critérios de avaliação presentes no plano de ensino [1] e nos slides da aula 10 [4], fornecendo um direcionamento preciso para a avaliação do conteúdo esperado nos artefatos. Essa etapa se baseia em um checklist elaborado a partir da leitura do plano e dos slides, abrangendo questionamentos específicos sobre a construção dos léxicos [3].
A segunda abordagem se apoia na técnica formal de inspeção de Fagan, um processo estruturado que visa identificar e corrigir possíveis erros, falhas e problemas nos artefatos analisados, abrangendo documentos, código-fonte, especificações, entre outros itens relacionados a projetos de desenvolvimento de software. Essa técnica proporciona uma revisão criteriosa e sistemática, contribuindo para a melhoria da qualidade e precisão dos artefatos [2]. A inspeção de Fagan é ilustrada na Figura 1 apresentada abaixo, demonstrando as etapas envolvidas no processo.
Conteúdo esperado
Espera-se que o artefato apresente uma lista de léxicos, com descrições claras, além de seguir a estrutura padrão básica exigida para todos os artefatos.
Gravação da verificação
No vídeo 1, destacado abaixo, é realizada a verificação do artefato léxicos conforme o checklist elaborado para tal.
Vídeo 1: Gravação da verificação dos Léxicos. (Fonte: Ana Rocha e Jefferson França, 2023).
Verificação
Com base nisso, foram criadas as Tabela 1 e 2 a seguir, que relaciona as especificações ideais do artefato, indica se o requisito é atendido ou não e avalia a qualidade de acordo com a classificação a seguir:
Possui
- Sim
- Não
- Incompleto
Qualidade
- Ótimo (Atende todos os requisitos do conteúdo esperado)
- Bom (Atende parcialmente os requisitos do conteúdo esperado)
- Pode melhorar (Não atende os requisitos do conteúdo esperado)
A Tabela 1 contém perguntas no que diz respeito à formatação do artefato.
| ID | Descrição do Critério | Possui | Qualidade | Observação |
|---|---|---|---|---|
| 1 | O artefato possui introdução? | Sim | Ótimo | |
| 2 | Todas as tabelas e imagens do artefato possuem legendas, fontes e são introduzidas no texto? | Sim | Ótimo | |
| 3 | Possui links para os outros artefatos, caso necessário? | Sim | Ótimo | |
| 4 | O artefato possui bibliografia/referências bibliográficas? | Sim | Ótimo | |
| 5 | O artefato possui um histórico de versões? | Sim | Ótimo | |
| 6 | O artefato possui autor? | Sim | Ótimo | |
| 7 | O artefato possui revisor? | Sim | Ótimo |
A Tabela 2 contém perguntas no que diz respeito ao conteúdo do artefato.
| ID | Descrição do Critério | Possui | Qualidade | Observação |
|---|---|---|---|---|
| 1 | O artefato inclui a metodologia utilizada com sua descrição correspondente? | Sim | Ótimo | |
| 2 | Os léxicos estabelecem conexões e associações entre os termos, como sinônimos, antônimos, hiperônimos e hipônimos? | Sim | Bom | Nem todos os léxicos tem sinônimos, sugerimos revisar para ver se tem necessidade de adicionar. |
| 3 | Todos os léxicos possuem uma definição clara e concisa? | Sim | Ótimo | |
| 4 | Os léxicos cobrem as principais funcionalidades e interações do sistema? | Sim | Ótimo | |
| 5 | Os léxicos e suas definições são padronizados em todo o artefato? | Sim | Ótimo | |
| 6 | Os léxicos possuem relação com outros artefatos do projeto, como diagramas, especificações e casos de uso? | Imcompleto | Pode melhorar | Os léxicos são linkados apenas com os artefatos de elicitação de requisitos. Pode ser incluído um texto explicando que algumas ligações dos léxicos podem observadas no diagrama de casos de uso. |
| 7 | É apresentado pelo menos um léxico de cada categoria, sendo elas, verbo, estado e objeto? | Sim | Ótimo | |
| 8 | Todos os léxicos possuem classificação, sinônimo, noção e impacto? | Sim | Ótimo |
Correções e ajustes sugeridos
O artefato foi analisado com atenção aos checklists apresentados, atendendo a maioria dos critérios. No entanto, recomenda-se realizar ajustes de acordo com as observações detalhadas nas tabelas específicas de cada ID abaixo.
Referentes à Tabela 2:
- ID2 - Os léxicos estabelecem conexões e associações entre os termos, como sinônimos, antônimos, hiperônimos e hipônimos?
- ID6 - Os léxicos possuem relação com outros artefatos do projeto, como diagramas, especificações e casos de uso?
Bibliografia
[1] SALES, André Barros. Plano de ensino da disciplina. Disponível em: Aprender 3. Acesso em 24 de novembro de 2023. [2] SERRANO, Milene e Mauricio. Slide “Requisitos – Aula 23”. Disponível em: Aprender 3. Acesso 24 de novembro de 2023. [3] GRUPO 6. Documento de Léxicos do Grupo 6 da Disciplina de Requisitos de Software. Disponível em: Git Page. Acesso em 24 de novembro de 2023. [4] SERRANO, Milene e Mauricio. Slide “Requisitos – Aula 10”. Disponível em: Aprender 3. Acesso 24 de novembro de 2023.
Histórico de Versão
| Versão | Data de execução | Data prevista de revisão | Descrição | Autor(es) | Revisado |
|---|---|---|---|---|---|
1.0 |
24/11/2023 | 27/11/2023 | Criação do artefato | Ana Rocha e Jefferson França | |
1.1 |
24/11/2023 | 27/11/2023 | Execução da inspeção | Ana Rocha e Jefferson França |
Revisão
| Data de Revisão | Cobertura de Versões | Técnica | Revisor(es) |
|---|---|---|---|
| xx/xx/xxxx | 1.1 |
- | Yago |