Automated Review of Natural Language Requirements Documents: Generating Useful Warnings with User-extensible Glossaries Driving a Simple State Machine

TitleAutomated Review of Natural Language Requirements Documents: Generating Useful Warnings with User-extensible Glossaries Driving a Simple State Machine
Publication TypeConference Paper
Year of Publication2009
AuthorsPrateek Jain, Kunal Verma, Alex Kass, Reymonrod Vasquez
Conference NameAutomated Review of Natural Language Requirements Documents: Generating Useful Warnings with User-extensible Glossaries Driving a Simple State Machine
Abstract

We present an approach to automating some of the quality assurance review of software requirements documents, and promoting best practices for requirements documentation. The system we describe -- the Requirements Analysis Tool (RAT) - has been deployed and is currently being used in pilot projects with large and complex requirements documents. Preliminary results indicate a reduction in time needed to review documents and reduction in requirements defects as well as a change in the way users think about writing requirements. Our approach allows users to write requirements in natural language instead of an artificial formalism. RAT enforces requirements documentation best practices such as using standardized syntaxes and internally-consistent use of terminology. It supports the use of user-extensible glossaries to define terms. The formalism driving RAT is a state-machine, which is used to classify requirements into types based on keywords and then verify that the requirements follow one of the best practice syntaxes supported by the tool. It generates helpful warning messages explaining where requirements are not following best practices and suggests ways to rectify.

Full Text

Prateek Jain, Kunal Verma, Alex Kass and Reymonrod G. Vasquez;'Automated Review of Natural Language Requirements Documents: Generating Useful Warnings with User-extensible Glossaries Driving a Simple State Machine'; In Proceedings of ISEC'09, 2nd India Software Engineering Conference, Pune,Maharashtra, India, February 23-26, 2009
pages: 37-46
year: 2009
venue url: http://www.cse.iitd.ernet.in/~sigcse/isec2009/
hasEditor: Kiran Deshpande And Pankaj Jalote And Sriram K. Rajamani
related resource url: http://portal.acm.org/citation.cfm?doid=1506216.1506224
venue name: Second India Software Engineering Conference(ISEC2009)
hasURL: http://knoesis.wright.edu/library/publications/isec2009_submission_59.pdf
hasBookTitle: Proceedings of the Second India Software Engineering Conference(ISEC2009)