Formulate only one requirement per sentence formulate

This preview shows page 64 - 66 out of 182 pages.

Formulate only one requirement per sentence: Formulate requirements using active voice and use only one process verb. Long, complicated interlaced sentences must be avoided. 4.7 Glossary A frequent cause for conflicts in requirements engineering is that the peo- ple that are involved in the development process have different interpreta- tions of terms. In order to avoid these conflicts, it is necessary that every- one who is involved in the development process shares the same understanding of the terminology used. Therefore, all relevant terms must be defined in a common glossary. A glossary is a collection of term defini- tions and contains the following elements: Context-specific technical terms Abbreviations and acronyms Everyday concepts that have a special meaning in the given context
Image of page 64

Subscribe to view the full document.

46 4 Documenting Requirements Synonyms, i.e., different terms with the same meaning Homonyms, i.e., identical terms with different meanings Consistent definitions By defining the meaning of terms, you can increase the understandability of requirements considerably. Misunderstandings and different interpreta- tions of terms that might lead to conflicts can be avoided from the begin- ning. Reuse of glossary entries Often, in different projects, terms are used that are similar to one another or in fact identical. This may be the case, for example, when one system is developed for different customers but within the same domain. In this case, already existing glossary entries should be reused. It may even be feasible to define such terms in a universal, inter-project glossary. The additional effort of creating such a glossary will pay off in future projects. For certain domains, collections of term definitions already exist and are publicly accessible. These may serve as the foundation for the definition of specific glossaries. For example, in [IEEE Std. 610.12-1990] , typical terms of software engineering are defined. Rules for Using a Glossary Basic rules for using a glossary Since creating a glossary is absolutely mandatory, the following must be noted: The glossary must be centrally managed: At any time, there must be only one valid glossary, which must also be centrally accessible. There must not be multiple valid glossaries. Responsibility must be assigned: One particular individual must be assigned with the task of maintaining the glossary and ensuring con- sistency and up-to-dateness. The necessary resources to accomplish this task must be included in the project plan. The glossary must be maintained over the course of the project: In order to ensure that the glossary is consistent and up-to-date, it must be maintained over the course of the entire project by the person that was assigned this responsibility. The glossary must be commonly accessible: The term definitions must be available for all involved personnel. This is the only way a common understanding of the terms can be ensured.
Image of page 65
Image of page 66

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