Assertive Wiki: An Experience Report In The Industry on the Redesign of Software Requirements Documentation
Rhuan Viana, R. Guizzardi-Silva Souza, Wilson Silva, Flavia Camila Morais de Oliveira, Leonardo Tiago, Lennon Chaves · 2023
The development of requirements documentation in the software life cycle process is a crucial step in requirements engineering. However, due to excessive documentation, multiple databases for reference, and difficulties in understanding requirements, the testing process can become exhaustive. Existing literature already demonstrates that well-written documentation results in higher-quality product delivery. In summary, the industry focuses on clarity and objectivity in business rules, but does not address the issues of excessive documentation and multiple requirement databases. The aim of this study is to highlight the value of developing usable and useful documentation within the context of SIDIA, an Institute of Science and Technology. To achieve this, the Assertive Wiki was developed, comprising 45 wikis that document requirements based on the application of UX/UI Design and A/B Testing techniques. Through qualitative research conducted with a software testing team at SIDIA, it is demonstrated that 90% of the testers agree that the utilities and databases built in this manner are useful. Thus, it can be concluded that the applied requirements documentation process, through the use of Assertive Wiki, led to testers satisfaction with testing activities.