Гайд полностью на английском языке!

- Requirements Sentence Algorithm
- Characteristics of Requirements and Designs Quality
- Rules to Write High-Quality Requirements
- Use correct grammar
- Use correct spelling
- Use correct punctuation
- Ensure the subject and verb of the requirement are appropriate to the level to which the requirement refers.
- Focus on the problem “what” rather than the solution “how.”
- Define terms
- Use each term consistently throughout requirement sets.
- Use a consistent set of acronyms.
- Avoid the use of abbreviations in requirement statements.
- Use a defined convention to express logical expressions.
- Express each requirement once and only once
- Enumerate sets explicitly instead of using a group noun to name the set.
- Write a single sentence that contains a single thought conditioned and qualified by relevant subclauses.
- Use a separate clause for each condition or qualification.
- State applicability conditions explicitly
- Express the propositional nature of a condition explicitly instead of giving lists of conditions.
- When a requirement is related to complex behavior, refer to the supporting diagram or model.
- Use the definite article “the” rather than the indefinite article “a.”
- Use the active voice in the main sentence structure with the responsible entity clearly identified.
- Avoid the use of “not.”
- Avoid the use of vague terms.
- Avoid the use of the oblique (“/”) symbol.
- Avoid escape clauses.
- Avoid open-ended clauses.
- Avoid combinators.
- Avoid the use of pronouns and indefinite pronouns.
- Use “each” instead of “all”, ”any”, or ”both” when universal quantification is intended.
- Avoid superfluous infinitives.
- Avoid indefinite temporal keywords, define temporal dependencies explicitly.
- Avoid phrases that indicate the purpose of the requirement (not in User Story)
- Avoid parentheses and brackets containing subordinate text.
- Avoid using unachievable absolutes.
- Provide specific measurable performance targets appropriate to the level at which the requirement is stated.
- Use appropriate units when stating quantities.
- Define quantities with a range of values appropriate to the level stated.
- Words to Avoid in Requirements
- Requirements Attributes

Формат документа .pdf