3 min read

How to Write Good Requirements: 10 Tips and Examples

How to Write Good Requirements: 10 Tips and Examples

Writing good requirements is essential for the success of any project. Clear, concise, and well-defined requirements set the foundation for a project's scope, deliverables, and success criteria. 

This blog explores valuable tips and examples to help you master the art of writing good requirements based on insights from years of experience in project management. If you are brand new to writing requirements, check out our comprehensive guide to requirements management.

10

#1 Understand Your Stakeholders 


One of the key tips to writing great requirements is understanding your stakeholders. By identifying and involving all relevant stakeholders from the beginning, you can ensure that their needs and expectations are captured in the requirements. This collaborative approach leads to more comprehensive and accurate requirements.

#2 Understand What Is Needed 


There is a huge difference between want and need. One way to establish the difference is by asking yourself if the system will work without that requirement. Rather than focusing on possible solutions, simply list what the system needs - the solution can come later.

#3 Remember the CONOPs


The Concept of Operations (CONOPS) is a valuable artifact. The CONOPS will be something that all the stakeholders understand and collaborate on together. Create different scenarios and needs. From there, you will better understand where to start with your requirements.

The CONOPS will help you write quality requirements by finding all the assumptions. It will help evaluate the ‘what if’ scenarios, make testing easier, and formulate your needs into the requirements.

#4 Be Specific, But Not Too Specific


Writing specific requirements is crucial to avoid ambiguity and misinterpretation. However, it is also important not to be overly specific, as this can limit flexibility and creativity in finding solutions. Finding the right balance between specificity and flexibility is key to writing effective requirements.

#5 Give Requirements, Not Instructions


Understand what is needed and create requirements from those needs. This is why knowing your stakeholders is so important. If you understand your stakeholders' needs, writing requirements rather than instructions becomes an easier task.

Requirements should provide enough information to allow the builder to provide the most cost-effective solution to the problem.

#6 Include a Number, Name, and Description


Each requirement should be uniquely identified with a number and name for easy reference and tracking. Additionally, a clear and concise description of the requirement is essential to ensure that all stakeholders have a common understanding of what is being requested.

#7 Ensure Traceability


Traceability is vital in requirements management to establish relationships between requirements, design, implementation, and testing. A requirement that refers to the name of another entity may be related to that entity with a "traced to,“ "satisfied by," or "verified by" relation, as appropriate.

By tracing requirements throughout the project lifecycle, you can ensure that each requirement is satisfied and verified, leading to a successful project outcome.

#8 Include a Rationale


A rationale justifies the inclusion of a specific requirement. Attach a rationale for each requirement by explaining the need for the requirement. The rationale provides reviewers and implementers with additional information on the intent of the requirements and avoids confusion down the line.

#9 Use Proper Grammar


Maintaining proper grammar in requirement documentation is crucial for clarity and consistency. Using proper grammar will prevent costly mistakes due to confusion.

Some grammar mistakes that can cause confusion are:

  • Run-on sentences result in two requirements appearing to be one.
  • Their, they’re, and there
  • Misspellings
  • To and Too

By following established standards, you can enhance the quality of your requirements and facilitate communication among team members. It never hurts to use a tool like Grammarly. Grammarly works within your browser, so you can even use it with Innoslate.

#10 Use a Standard


Use a standard to ensure consistency while writing your requirements, choosing one that is right for your industry.

Common standards are: 

  • MIL-STD-490: The United States Military Standard establishes the format and content for the United States Department of Defense’s objectives. It can be useful in other areas as well.
  • IEEE: The Institute of Electrical and Electronics Engineers Standards Association develops the IEEE standards. Unlike the MIL-STDs, the IEEE reaches a broad range of industries, including transportation, healthcare, information technology, power, energy, and much more.
  • ISO: The International Organization for Standardization develops standards for businesses to optimize productivity and minimize costs.

SPEC Innovations offers a library of curated standards parsed and ready to be imported into Innoslate. Check out the Digital Curation Station.

 

Example: Applying the Tips in Practice 

Let's consider an example of applying these tips in practice. Imagine you are tasked with developing a new mobile application. A well-written requirement for this project could be:

  • Requirement Number: MA-001
  • Requirement Name: User Authentication
  • Description: The mobile application shall require users to log in using their email address and password to access personalized content.

By following the tips outlined above, this requirement is specific, traceable, and adheres to proper grammar and standards, setting a solid foundation for the project.

Writing good requirements is a skill that can significantly impact the success of a project. By understanding stakeholders, being specific yet flexible, including essential details, ensuring traceability, and following proper grammar and standards, you can enhance the quality of your requirements.

Incorporating these tips and examples into your requirement writing process will help you deliver successful projects that meet stakeholder expectations and objectives.

Drawing ≠ Models: Understanding the Distinction in MBSE

Drawing ≠ Models: Understanding the Distinction in MBSE

Model-Based Systems Engineering (MBSE) has become a prominent term in the engineering world. The concepts of “modeling” and “simulation” are...

Read More
Ford vs. Mazda Transmissions

Ford vs. Mazda Transmissions

FORD VS. MAZDA TRANSMISSIONS Why Quality Matters In the 80s Ford owned roughly 25% of Mazda (then known as Toyo Koygo) and had Mazda manufacture...

Read More
Non-Functional vs. Functional Requirements: When to Use Each Type

Non-Functional vs. Functional Requirements: When to Use Each Type

When developing a system, understanding and writing effective requirements is crucial for ensuring the final product meets the intended needs....

Read More