Requirement dependencies

If you want to create links to reference requirements between one and another, you will use what we call dependencies. This page will teach you how to create dependencies with multiple use cases.

You can also take a look at the tutorial for more information:

How to create a dependency?

Using tables

• When you write your requirements in tables, whether in Horizontal, or Vertical, you will simply have to add the /requirement yogi link macro to your requirement line.

• The name of the relationship is the one you put in the column header.

• The requirement link added in the line of the requirement will use a To, or Parent direction.

In the first example below: FN-01 references BR-01 and DIS-REQ-001 as a To / Parent dependency, with the relationship Refines.

Horizontal Tables	Vertical Tables

Using paragraphs

When you write requirements using paragraphs, we will index the paragraph as the content of the requirement. And the dependencies work the same way as above:

• Write your requirement definition and put a /requirement yogi link macro in the same paragraph for us to index it as a dependency.

• By default, the name of the relationship will be Dependency but you can customize it with the RY Configuration macro > Paragraph Configuration (see docs).

• Same as the tables, the requirement link added in the definition of the requirement will use a To, or Parent direction.

In the example below, TECHNICAL REQUIREMENT 001 references LIDAR 001, with the relationship Dependency.

Using Linear Docs

When you write requirements outside of tables, and need a better customization than the paragraphs, we have a feature called Linear Documents.

💡Linear documents create requirement keys for each heading, we index the heading text as the description, and everything that is written in that section will be the @Content of the requirement. If you are not familiar with linear docs, we recommend to read the documentation and test the feature: Linear documents: Manage requirements outside of tables .

There are two ways to create dependencies using Linear Documents:

1. Automatic dependencies: Linear docs index dependencies using the heading hierarchy. H1 titles reference H2 titles, which also reference H3 titles, etc.

   1. In the example below, you can see the heading 4.1.1 references headings 4.1.1.2 and 4.1.1.1, and is referenced by heading 4.1.

2. Usual way: Using the /requirement yogi link macro anywhere in your paragraphs, and we’ll index it as a dependency of the last heading.

   1. In the example below, you can see the Heading 1.2 references MSFC-STF-3716 with the link macro.

Using the parent requirement configuration

When you are writing your specifications, and using a page-per-feature structure, you may define the highest requirement first in the page, and then define sub requirements in the same page. You may want all those sub-requirement to reference this higher level requirement, automatically. Using the RY Configuration macro, and the Parent requirement Configuration, you can achieve that. See the documentation for the full explanation: Parent Requirement Configuration.

In the example below, my feature AUTO-BR-01 is the higher level requirement, and all my AUTO-FN requirements automatically reference the parent with the configuration.

How to trace dependencies?

Search syntax

You can use a specific search syntax to look for requirements with specific dependencies. We have two terms to identify the requirement who references another, and the requirement who is referenced. You can use either TO/FROM or PARENT/CHILD. Here are a few examples:

The syntax is a bit more different for Linear Documents, so please explore the docs for more information: Search syntax

Traceability Matrix

You can create your matrices and display multiple levels of requirement dependencies in your reports.

• Click on the cog menu of your requirement’s column.

• Display sub level requirements by clicking on FROM, and select the relationship.

• Display higher level requirements by clicking on TO, and select the relationship.

• It is possible to go several layers deep in the levels of requirements

Dependency graph

When viewing your requirement detail, scroll down and view your requirements in a graphical way to navigate between dependencies.

• Higher level requirements are displayed on the left, sub-level requirements on the right, and Jira issues below.

• Click on a requirement to see its detail.

• Click on a relationship name and be redirected to the search to find dependencies with that relationship.

Most asked questions

I cannot remember what TO and FROM is ? What is the direction of dependencies?

• Quick way to remember how to use the TO and FROM in the search syntax is to use the sentence "I want to find requirements that point / reference to another requirement", so use TO in the search.

• Parent and To execute the same search: requirements which reference another.

• Child and From execute the same search: requirements which are referenced by another.

How do I find requirement dependencies to deleted requirements?

You can navigate to the Cleanup Tasks and look for ‘Dead requirement links’. Please see more information here: Cleanup Tasks