Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

What use-cases does it address?

  • "I have 2 customers, and their requirements are slightly different": Variants will help you see the differences between the requirements.

  • "We must keep the public version intact, while we're currently working on the next version of the product": You'll have 2 variants, the "Current" and the "Last release". You're working on the Current, and you can still make changes in the "Last release". The modification matrix will be very useful for you.

  • "I want to keep each version of our requirements, every day": Variants are limited to 5 for the moment, and they are not designed for versioning. Variants are more like "branches" in a version control system. One of the reasons is that you must keep a copy of each page with requirements, for each requirement, and we don't want to incentivize you to create hundreds of Confluence pages.

  • "I want blocks of text to appear and disappear depending on which customer is viewing the text": Variants are based on having one page of the same text for each variant. You will have to play with restrictions, page names or use other plugins if you want more control around content management. Variants are not designed to alter pages or manage their visibility.

...

How to use them and where to find them?

...

On the Search page, you can search the requirements that belong to a variant.

By default, the current variant of the space is used.

Image RemovedImage Added

On the Traceability matrix page, you can display the requirements that belong to a variant.

By default, the current variant of the space is used.

From the suggestion menu, you can add a column Variant.

Image RemovedImage Added

When clicking on a requirement, the details are displayed.

The associated variant is displayed as a dropdown list.

You can switch between the variants where the requirement exists.

Note: When selecting another variant, it does not assign it to the requirement.

Image RemovedImage Added

In Jira, the variant associated to the requirement is displayed between the parenthesis.

Image RemovedImage Added

On the Modification matrix page, you can follow the evolution of a requirement between 2 or more variants.

See Modification matrix for more information.

Image RemovedImage Added

On a Confluence page where you created your requirement, click on Requirement Yogi icon in the byline section.

Then you can reindex the page using another variant, listed in the dropdown list.

Image Added

How to administer?

The "administration" panel is located on the right of the screen, and only space administrators can edit variants.

...

The Current variant is the variant by default, and you cannot edit or delete it. Unless specified otherwise, all your Confluence pages and their requirements will be assigned to the Current variant.

The number of variants per space is currently limited to 5. 

Related pages

...

Child pages (Children Display)