For language also referred to as sprachgefühl is a

This preview shows page 72 - 74 out of 182 pages.

for language (also referred to as “Sprachgefühl”) is a valuable tool to help gauge which process word must be supplemented in order to be considered complete. Similarly, adjectives and adverbs may need to be supplemented as well. While the effect is much less frequent with these types of words than with verbs, it is often hard to recognize. Avoid passive voice. The use of incompletely specified process words can mostly be avoided or kept to a minimum if requirements are formulated using the active voice rather than the passive voice. Use active voice. In this requirement using passive voice, it is unclear who enters the login data. It is also unclear where and how this is done. If this requirement is reformulated using the active voice, at least the agent or person responsible must be included. The same requirement using active voice might be as follows: 5.2 Requirement Construction using Templates Quality by means of requirements templates and glossaries Requirements templates provide a simple and easily understandable approach to reduce language effects when documenting requirements. Templates support the author in achieving high quality and syntactic unambiguousness in optimal time and at low costs. Example 5-7: Requirement using the passive voice To log a user in, the login data is entered. Example 5-8: Requirement using active voice The system must allow the user to enter his user name and password using the keyboard of the terminal. Definition 5-1: Requirements Template A requirements template is a blueprint for the syntactic structure of individual requirements.
Image of page 72

Subscribe to view the full document.

54 5 Documenting Requirements in Natural Language In order to achieve lexical clearness in the documentation as well, it is wise to use requirements templates in conjunction with project glossaries (see section 4.7 ). The following is a step-by-step description of the correct application of requirements templates. Step 1: Determine the Legal Obligation How legally binding is a requirement? In the beginning, you should determine the degree of legal obligation for a requirement. Usually, one distinguishes between legally obligatory requirements, urgently recommended requirements, and future require- ments. To achieve this within a requirement, you can use the modal verbs shall , should , and will . Alternatively, the legal obligation of a requirement can be documented by a specific requirements attribute. Step 2: The Requirement Core Determine the required process. The core of each requirement is the functionality that it specifies (e.g., print, save, paste, or calculate). This functionality is referred to as the process . Processes are activities and may only be described using verbs. The process that depicts the system behavior by means of a requirement is to be described in step 2.
Image of page 73
Image of page 74

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