Natural language requirements boilerplates: an integrative literature review

Detalhes bibliográficos
Autor(a) principal: Barbosa, Leonardo de Mello
Data de Publicação: 2023
Outros Autores: Cerqueira, Christopher Shneider, da Cunha, Antonio Eduardo Carrilho
Tipo de documento: Artigo
Idioma: eng
Título da fonte: GeSec
Texto Completo: https://ojs.revistagesec.org.br/secretariado/article/view/2610
Resumo: 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.
id SINSESP_c1cc6f85ff06ac5dee26d57d31996dc6
oai_identifier_str oai:ojs2.revistagesec.org.br:article/2610
network_acronym_str SINSESP
network_name_str GeSec
repository_id_str
spelling Natural language requirements boilerplates: an integrative literature reviewRequirements EngineeringRequirements BoilerplatesNatural LanguageIn 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.Revista de Gestão e Secretariado2023-08-15info:eu-repo/semantics/articleinfo:eu-repo/semantics/publishedVersionapplication/pdfhttps://ojs.revistagesec.org.br/secretariado/article/view/261010.7769/gesec.v14i8.2610Revista de Gestão e Secretariado (Management and Administrative Professional Review); Vol. 14 No. 8 (2023): Revista de Gestão e Secretariado v.14, n.8, 2023; 13444-13476Revista de Gestão e Secretariado; Vol. 14 Núm. 8 (2023): Revista de Gestão e Secretariado v.14, n.8, 2023; 13444-13476Revista de Gestão e Secretariado; v. 14 n. 8 (2023): Revista de Gestão e Secretariado v.14, n.8, 2023; 13444-134762178-9010reponame:GeSecinstname:Sindicato das Secretárias do Estado de São Paulo (SINSESP)instacron:SINSESPenghttps://ojs.revistagesec.org.br/secretariado/article/view/2610/1476Barbosa, Leonardo de MelloCerqueira, Christopher Shneiderda Cunha, Antonio Eduardo Carrilhoinfo:eu-repo/semantics/openAccess2023-08-23T11:26:48Zoai:ojs2.revistagesec.org.br:article/2610Revistahttps://www.revistagesec.org.br/ONGhttps://ojs.revistagesec.org.br/secretariado/oaieditor@revistagesec.org.br | gestoreditorial@revistagesec.org.br | rf.sabino@gmail.com2178-90102178-9010opendoar:2023-08-23T11:26:48GeSec - Sindicato das Secretárias do Estado de São Paulo (SINSESP)false
dc.title.none.fl_str_mv Natural language requirements boilerplates: an integrative literature review
title Natural language requirements boilerplates: an integrative literature review
spellingShingle Natural language requirements boilerplates: an integrative literature review
Barbosa, Leonardo de Mello
Requirements Engineering
Requirements Boilerplates
Natural Language
title_short Natural language requirements boilerplates: an integrative literature review
title_full Natural language requirements boilerplates: an integrative literature review
title_fullStr Natural language requirements boilerplates: an integrative literature review
title_full_unstemmed Natural language requirements boilerplates: an integrative literature review
title_sort Natural language requirements boilerplates: an integrative literature review
author Barbosa, Leonardo de Mello
author_facet Barbosa, Leonardo de Mello
Cerqueira, Christopher Shneider
da Cunha, Antonio Eduardo Carrilho
author_role author
author2 Cerqueira, Christopher Shneider
da Cunha, Antonio Eduardo Carrilho
author2_role author
author
dc.contributor.author.fl_str_mv Barbosa, Leonardo de Mello
Cerqueira, Christopher Shneider
da Cunha, Antonio Eduardo Carrilho
dc.subject.por.fl_str_mv Requirements Engineering
Requirements Boilerplates
Natural Language
topic Requirements Engineering
Requirements Boilerplates
Natural Language
description 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.
publishDate 2023
dc.date.none.fl_str_mv 2023-08-15
dc.type.driver.fl_str_mv info:eu-repo/semantics/article
info:eu-repo/semantics/publishedVersion
format article
status_str publishedVersion
dc.identifier.uri.fl_str_mv https://ojs.revistagesec.org.br/secretariado/article/view/2610
10.7769/gesec.v14i8.2610
url https://ojs.revistagesec.org.br/secretariado/article/view/2610
identifier_str_mv 10.7769/gesec.v14i8.2610
dc.language.iso.fl_str_mv eng
language eng
dc.relation.none.fl_str_mv https://ojs.revistagesec.org.br/secretariado/article/view/2610/1476
dc.rights.driver.fl_str_mv info:eu-repo/semantics/openAccess
eu_rights_str_mv openAccess
dc.format.none.fl_str_mv application/pdf
dc.publisher.none.fl_str_mv Revista de Gestão e Secretariado
publisher.none.fl_str_mv Revista de Gestão e Secretariado
dc.source.none.fl_str_mv Revista de Gestão e Secretariado (Management and Administrative Professional Review); Vol. 14 No. 8 (2023): Revista de Gestão e Secretariado v.14, n.8, 2023; 13444-13476
Revista de Gestão e Secretariado; Vol. 14 Núm. 8 (2023): Revista de Gestão e Secretariado v.14, n.8, 2023; 13444-13476
Revista de Gestão e Secretariado; v. 14 n. 8 (2023): Revista de Gestão e Secretariado v.14, n.8, 2023; 13444-13476
2178-9010
reponame:GeSec
instname:Sindicato das Secretárias do Estado de São Paulo (SINSESP)
instacron:SINSESP
instname_str Sindicato das Secretárias do Estado de São Paulo (SINSESP)
instacron_str SINSESP
institution SINSESP
reponame_str GeSec
collection GeSec
repository.name.fl_str_mv GeSec - Sindicato das Secretárias do Estado de São Paulo (SINSESP)
repository.mail.fl_str_mv editor@revistagesec.org.br | gestoreditorial@revistagesec.org.br | rf.sabino@gmail.com
_version_ 1838625561568608256