Requirement Versioning and Releasing

To effectively navigate the dynamic landscape of evolving requirements throughout the product life cycle, our new feature (as of April 2024) introduces a versioning system using the change history. This system assigns version numbers to requirements, enabling meticulous tracking and management. With the capability to release requirements post-gate reviews or milestones, this feature ensures a systematic approach to capturing changes and updates. Moreover, users can seamlessly utilise baselines to revisit and analyse previous versions of specifications, providing a comprehensive view of the product development journey.

This Versions feature enhances the overall tracking and management of requirements and specifications, fostering a more streamlined and adaptable product development process.

Requirement Level Versioning Copy Link Copied

Versioning initiates at the requirements level, commencing at 0. Any modification to the attributes of a requirement, such as alterations to the requirement text, identifier, rationale, etc., automatically triggers a minor version increment, transitioning, for instance, from 0 to 0.1.

In short, any updates on the requirement which are saved/added to the “requirement” history field associated with a requirement, the version number of the requirement is likewise adjusted to reflect these changes. This systematic approach ensures a comprehensive and traceable versioning system for requirements throughout their lifecycle.

❯ ❮

List of Changes that Trigger a Version Number Increment

Here are the list of changes in the requirement that trigger the minor version increment

• Editing the Text of the Requirement’s attributes such as “Text”, ”Title”, “Rationale”, “custom columns”

• Adding or Removing the “Parent” and “Children”

• Changing the “Type”, “State”, “Compliance”

• Adding or removing the tags

Release Requirements

Upon finalization of a requirement during the product development phase, achieved thorough reviews, milestones, baselines, or gate reviews, the requirement becomes eligible for release. This signifies a major release for the requirement, which can be executed using the release option associated with the requirement. The act of releasing requirements not only marks their completion but also serves as the conclusive step in version finalization.

Release icon - The release Icon represents the status of the released requirement.

How to Release Requirements Copy Link Copied

The release option can be accessed through the three dots icon in the “Action” menu, allowing users to release requirements individually or in bulk.

How to release a requirement - The image shows the steps to access the “Release feature”

A quick video to demonstrate the bulk release of the requirements is shown below.

Release Specifications Copy Link Copied

Users have the option to release specifications associated with multiple requirements. They can access this option by right-clicking the specification name in the tree hierarchy (refer to Figure Release Specification).

Release Specification - Image illustrates on how to release specification

Upon selecting the release option on the specification level, the users have two options to release the specification.

Release Specification options - Current options within the release specification menu

Associate all requirements current version

The first option, “Associate all requirements current version”, releases all the requirements within the specification and makes the specification release.

Scenarios

• Note that the requirements that are in the released state are not released.

• If the requirement was released and some changes were done to the requirement, the requirement with changes is released again.

Associate only requirements with released versions

Contrary to the first option, the second option, “Associate only requirements with released versions”, takes only the released requirements at that time within the specification and releases the specification. For example, if you have 5 released requirements and 5 unreleased requirements, the specification release creates a specification version with only the 5 released requirements.

Release Requirements by Reviews Copy Link Copied

Users can initiate the release of requirements via the Review Center. After the reviewer completes the review, it must be approved by the approver to conclude the review process. The approver has the option to "Release Requirements" as part of finalizing the review (refer to the Figure Release requirements through the Review center).

Release requirements through the Review center