Implications of the violation of documentation

This preview shows page 111 - 114 out of 182 pages.

Implications of the violation of documentation guidelines Ignoring the documentation guidelines can, among other things, lead to the following risks: Impairment of development activities: It may be impossible to carry out development activities that are based upon a specific documentation format.
Image of page 111

Subscribe to view the full document.

7.3 Quality Aspects of Requirements 93 Misunderstandings: Requirements may not be understandable or may be misunderstood by the people that need to comprehend them. As a result, the requirement may be unusable. Incompleteness: Relevant information is not documented in the requirements. Overlooking requirements: If requirements are not documented at the position that they are supposed to in the requirements document, these requirements may be overlooked in subsequent activities. Test criteria of the quality aspect “documentation” Requirements validation with regard to the quality aspect “documenta- tion” is successful when requirements validation has been applied to the following error types and no significant shortcomings have been detected: Conformity to documentation format: Are the requirements docu- mented in the predetermined documentation format? For instance, has a specific requirements template or a specific modeling language been used to document the requirements? Conformity to documentation structures: Has the structure of the require- ments document been maintained? For instance, have all requirements been documented at the proper position in the document? Understandability: Can all documented requirements be understood in the context given? For instance, have all terms used been defined in a glossary (see section 4.7 )? Unambiguity: Does the documentation of the requirements allow for only one interpretation or are multiple different interpretations possi- ble? For instance, does a text-based requirement not possess any kind of ambiguity? Conformity to documentation rules: Have the predetermined documen- tation rules and documentation guidelines been met? For instance, has the syntax of the modeling language been used properly? 7.3.3 Quality Aspect “Agreement” The quality aspect “agreement” deals with checking requirements for flaws in the agreement of requirements between stakeholders. Last opportunity for changes During the course of requirements engineering, stakeholders gain novel knowledge about the system to be developed. Due to this additional knowledge, the opinion of the stakeholders regarding a requirement that has already been agreed upon can change. During requirements valida-
Image of page 112
94 7 Requirements Validation and Negotiation tion, stakeholders have the opportunity to requests changes without impairing the subsequent development activities. Requirements validation with regard to the quality aspect “agreement” is successful when requirements validation has been applied to the follow- ing error types and no significant shortcomings have been detected: Three test criteria of the quality aspect “agreement” Agreed: Is every requirement agreed upon with all relevant stakehold- ers?
Image of page 113

Subscribe to view the full document.

Image of page 114

What students are saying

  • Left Quote Icon

    As a current student on this bumpy collegiate pathway, I stumbled upon Course Hero, where I can find study resources for nearly all my courses, get online help from tutors 24/7, and even share my old projects, papers, and lecture notes with other students.

    Student Picture

    Kiran Temple University Fox School of Business ‘17, Course Hero Intern

  • Left Quote Icon

    I cannot even describe how much Course Hero helped me this summer. It’s truly become something I can always rely on and help me. In the end, I was not only able to survive summer classes, but I was able to thrive thanks to Course Hero.

    Student Picture

    Dana University of Pennsylvania ‘17, Course Hero Intern

  • Left Quote Icon

    The ability to access any university’s resources through Course Hero proved invaluable in my case. I was behind on Tulane coursework and actually used UCLA’s materials to help me move forward and get everything together on time.

    Student Picture

    Jill Tulane University ‘16, Course Hero Intern

Ask Expert Tutors You can ask 0 bonus questions You can ask 0 questions (0 expire soon) You can ask 0 questions (will expire )
Answers in as fast as 15 minutes