Natural language requirements boilerplates: an integrative literature Review/Matrizes de requisitos em linguagem natural: uma revisao integrativa de literatura

• Published in: GeSec : Revista de Gestão e Secretariado Vol. 14; no. 8; p. 13444
• Main Authors: Barbosa, Leonardo de Mello, Cerqueira, Christopher Shneider, Cunha, Antonio Eduardo Carrilho da
• Format: Journal Article
• Language: Portuguese
• Published: Sindicato das Secretarias e Secretarios do Estado de Sao Paulo 01-08-2023
• Subjects: Computational linguistics; Language processing; Natural language interfaces
• ISSN: 2178-9010; 2178-9010
• DOI: 10.7769/gesec.v14i8.2610

In the field of Requirements Engineering, natural language is the most widely used form of documenting systems requirements, mainly for its expressiveness power, freedom of words, and easiness of use. On the other hand, written requirements are frequently ambiguous, incomplete, and incorrect, among other defects, impacting into the system lifecycle. To mitigate this issue, researchers have, since 1998, developed dozens of sets of boilerplates, aiding to guide natural language requirements composition. In this integrative literature review, authors searched for these sets in traditional academic databases, grey literature, and professional media, leading to a list of 54 relevant documents. Analysis of these primary works revealed that, even when boilerplate creators wish their artifacts to be used on all kinds of systems, they are generally cataloged under the Computer Science umbrella. It turned out to be evident that ambiguity is the main issue of quality of requirements addressed by boilerplates, followed by completeness and consistency. Authors mapped the requirements boilerplates definition modes, concluding that plain sentences are the foremost choice to describe these creations. It is claimed that systematization on the construction and evaluation of requirements boilerplates is still a problem to render these activities repeatable and reproducible, as the largest part of documents does not report it. Finally, the reported evaluation methods were hierarchically clustered, leading to three typical approaches for this activity. Keywords: Requirements Engineering. Requirements Boilerplates. Natural Language. No campo da Engenharia de Requisitos, a linguagem natural e a forma mais amplamente utilizada para documentacao de requisitos de sistema, sobretudo por sua expressividade, acessibilidade e facilidade de uso. Por outro lado, os requisitos escritos frequentemente se mostram ambiguos, incompletos ou incorretos, dentre outros defeitos, impactando o ciclo de vida do sistema. A fim de mitigar tais falhas, os pesquisadores tem, desde 1998, desenvolvido dezenas de conjuntos de matrizes textuais, auxiliando a redacao de requisitos em linguagem natural. Nesta revisao integrativa de literatura, os autores buscaram por tais conjuntos nos bancos de dados academicos, na literatura cinza e nos meios profissionais, resultando em uma lista de 54 documentos relevantes. A analise destes trabalhos primarios revelou que, mesmo com os criadores das matrizes desejando que seus artefatos sejam utilizados para todo o tipo de sistemas, eles sao normalmente catalogados como pertinentes a Ciencia da Computacao. Mostrou-se evidente que a nao-ambiguidade e o fator de qualidade de requisitos mais diretamente almejado pelas matrizes, seguido de completude e consistencia. Os autores mapearam os modos de definicao das matrizes, concluindo que as sentencas simples sao a principal escolha quanto a forma de apresentacao das criacoes. Ressalta-se que a sistematizacao da construcao e avaliacao de matrizes de requisitos ainda e um problema para tornar tais atividades repetiveis e reproduziveis, ja que a maior parte dos documentos relevantes nao a registra. Por fim, os metodos de avaliacao registrados foram hierarquicamente agrupados, levando a tres abordagens tipicas para a atividade. Palavras-chave: Engenharia de Requisitos. Matrizes de Requisitos. Linguagem Natural.