How to write requirements

How do you write requirements with Requirement Yogi?

There are a couple of actions you can take to write and structure your requirements:

• The tables

• The key patterns

• The Requirement Types

• The writing style

Best Practice 1: Put your requirements in Tables

We recommend you to write your requirements in tables, this way you’ll be able to assign properties and dependencies to your requirements, and have a clear traceability and readability of your specifications.

Best practice 2: Defining your key pattern

We recommend to keep your requirement keys concise, but you are rather free in terms of format. You can use:

• most keyboard symbols

• Paragraph symbol

• blank spaces

• Language characters like arab, german, or japanese.

However, do not use % , / or \.

In terms of prefix, and what patterns you should use, we recommend to group your requirements per type. This prefix will allow you to look for all similar requirements, and will also allow us to autosuggest the next requirements you want to create.

• For example, business requirements, functional requirements and technical requirements: BR-PRODUCT-001, FN-PRODUCT-001 , TECH-PRODUCT-001.

For the numbering, we recommend to put an extra 0 depending on the number of requirements you plan to have. This will simply help us to keep the order in the search and traceability, making sure number 10 will be put correctly in order after the number 9.

Best Practice 3: Ways to add your first requirement

There are more than one way to create new requirements.

• I am writing my requirements one by one, as I create my specifications:

  • Use the /req shortcut to add our macros. You’ll be able to write your requirement key and insert it.

• Inserting the requirement macro individually takes me too much time, I want to generate my requirements:

  • Use the Transformation wizard,

Best Practice 4: Use Requirement Types