Podcast
Questions and Answers
Which of the following is NOT a characteristic of a good requirement?
Which of the following is NOT a characteristic of a good requirement?
What is the purpose of documenting critical information and maintaining a list of relevant documents?
What is the purpose of documenting critical information and maintaining a list of relevant documents?
Why should specifications state WHAT is needed, not HOW it is to be provided?
Why should specifications state WHAT is needed, not HOW it is to be provided?
Which of the following is NOT a common problem in writing requirements?
Which of the following is NOT a common problem in writing requirements?
Signup and view all the answers
What is the purpose of documenting assumptions, even if the authors were provided the correct information?
What is the purpose of documenting assumptions, even if the authors were provided the correct information?
Signup and view all the answers
Why is it important for a requirement to express a single thought?
Why is it important for a requirement to express a single thought?
Signup and view all the answers
Which of the following is a common trap in writing requirements that can lead to verification problems?
Which of the following is a common trap in writing requirements that can lead to verification problems?
Signup and view all the answers
What is the problem with stating operations instead of a requirement?
What is the problem with stating operations instead of a requirement?
Signup and view all the answers
What is the difference between 'shall', 'will', and 'should' in a specification?
What is the difference between 'shall', 'will', and 'should' in a specification?
Signup and view all the answers
Study Notes
Writing Good Requirements: Necessity, Verification, Attainability, and Clarity
- A good requirement is necessary, verifiable, and attainable.
- A requirement must state something that can be verified by examination, analysis, test, or demonstration to be verifiable.
- Subjective statements or words are not verifiable.
- A requirement must be attainable, technically feasible, and fit within budget, schedule, and other constraints.
- Each requirement should express a single thought, be concise, and simple.
- Bad assumptions occur when requirement authors do not have access to sufficient information or the information does not exist.
- Documenting critical information and maintaining a list of relevant documents can eliminate bad assumptions.
- Assumptions should be documented even if the authors were provided the correct information.
- Specifications should state WHAT is needed, not HOW it is to be provided.
- Asking WHY a requirement is needed can help define the real requirements.
- Stating implementation can lead to over-specification and limit potential solutions.
- Common problems in writing requirements include making bad assumptions, writing implementation instead of requirements, describing operations instead of writing requirements, using incorrect terms, using incorrect sentence structure or bad grammar, missing requirements, and over-specifying.
Writing Good Requirements: Necessity, Verification, Attainability, and Clarity
- A good requirement is necessary, verifiable, and attainable.
- A requirement must state something that can be verified by examination, analysis, test, or demonstration to be verifiable.
- Subjective statements or words are not verifiable.
- A requirement must be attainable, technically feasible, and fit within budget, schedule, and other constraints.
- Each requirement should express a single thought, be concise, and simple.
- Bad assumptions occur when requirement authors do not have access to sufficient information or the information does not exist.
- Documenting critical information and maintaining a list of relevant documents can eliminate bad assumptions.
- Assumptions should be documented even if the authors were provided the correct information.
- Specifications should state WHAT is needed, not HOW it is to be provided.
- Asking WHY a requirement is needed can help define the real requirements.
- Stating implementation can lead to over-specification and limit potential solutions.
- Common problems in writing requirements include making bad assumptions, writing implementation instead of requirements, describing operations instead of writing requirements, using incorrect terms, using incorrect sentence structure or bad grammar, missing requirements, and over-specifying.
Common Traps in Writing Requirements
- Writing a design requirement when a data base is not necessary can lead to unnecessary solutions.
- Stating implementation can make the author believe that all requirements are covered, but important requirements may be missing.
- The problem of needs versus implementation occurs at each level of requirements development.
- To avoid stating implementation, ask yourself WHY you need the requirement to ensure it is a real need statement.
- Defining implementation instead of requirements is known as the implementation trap.
- Always ask WHY a requirement is needed to avoid falling into the lower level requirement trap.
- Stating operations instead of a requirement can lead to misunderstandings and verification problems.
- The use of shall, will, and should have specific meanings in a specification and must be used accordingly.
- All shall statements (requirements) must be verifiable to demonstrate compliance.
- Terms such as support, but not limited to, and etc. should be avoided in writing requirements.
- And/or should be used sparingly and only when necessary to avoid ambiguity.
- Understanding common traps in writing requirements can save time, money, and prevent misunderstandings.
Studying That Suits You
Use AI to generate personalized quizzes and flashcards to suit your learning preferences.
Description
Test your knowledge on writing good requirements with this informative quiz! Learn about the key characteristics of a good requirement, including its necessity, verifiability, attainability, and clarity. Discover how to avoid common mistakes such as bad assumptions, over-specification, and using incorrect terms. This quiz will help you understand the importance of expressing a single thought concisely and simply, and how to document critical information to eliminate bad assumptions. Take the quiz now and enhance your understanding of writing effective requirements!