Using the glossary must be obligatory all involved

This preview shows page 65 - 69 out of 182 pages.

Using the glossary must be obligatory: All involved personnel must be obliged to exclusively use the terms and term definitions as they have been defined in the glossary.
Image of page 65

Subscribe to view the full document.

4.8 Summary 47 The glossary should contain the sources of the terms: In order to be able to resolve questions and problems at any time during the course of the project, it must be possible to determine the source of a term. The stakeholders should agree upon the glossary: Only stakeholders can reliably validate the operational definitions for their respective project context. Each definition should be validated by the stakeholders or their representatives. In addition, the individual term definitions in the glossary should be explicitly approved. This approval signals that the respective term is correct and its use is obligatory. The entries in the glossary should have a consistent structure: All entries in the glossary must be structured in the same way. In order to support a consistent documentation, it is advisable to use a template for glos- sary definitions. In addition to the definition and the meaning of a term, the template should specify possible synonyms and homonyms. To reduce the effort of aligning terms with one another, it is advisable to start with the creation of the glossary early on in the project. 4.8 Summary The documentation of requirements plays a central role in requirements engineering. As the amount of requirements is often vast, it is very impor- tant to clearly structure the requirements so that personnel not involved with the project also understand them. Also, looking up and changing requirements is simplified and accelerated in this way. This makes meeting the quality criteria for requirements documents much easier. Using customized documentation structures has proven to be suitable for that purpose. These are completed by inserting project-specific requirements written in natural language in conjunction with conceptual requirements models.
Image of page 66
Image of page 67

Subscribe to view the full document.

49 5 Documenting Requirements in Natural Language Elicited requirements for the system to be developed are frequently docu- mented using natural language. Natural language has the advantage that it (allegedly) does not require preparation time in order to be read and understood by stakeholders [Robertson and Robertson 2006] . In addition, natural language is universal in the sense that it can be used to describe any circumstances. However, there are some problems associated with the use of natural language for requirements documentation. 5.1 Effects of Natural Language Subjective perception As natural language is inherently ambiguous and statements in natural lan- guage can often be interpreted in multiple ways, it is necessary to place spe- cial emphasis on potential ambiguities in such statements to satisfy the cri- terion of unambiguousness. Requirements are defined and read by people with different knowledge, different social backgrounds, and different expe- riences. The diversity among the people involved in the development proc-
Image of page 68
Image of page 69

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