We're introducing baselines. It's a way of versioning your requirements.
In 1.13.3, we've added an icon at the top of pages with requirements (in the "byline") to compare the current page with a baseline. In 1.13.4, we've added a step in the wizard of baseline creation, to tell the user when some requirements could be added to the baseline.
Baselines can be useful:
A baseline contains a snapshot of your requirements at a given point of time. There are 4 ways to create a baseline:
Create a baseline from a search
|Create a baseline from the Create button|
Create a baseline from the baseline screen
Create an "instant" baseline
An "instant" baseline has no associated page. Requirements are frozen immediately.
Baseline are often intellectually related to a release, to a test suite, etc. This is the reason why we've tied baselines to a summary page, so you can type any information relevant to this baseline, in free text:
Creating a page about the baseline is not enough. You must click "Freeze requirements". This allows you to enter details about a baseline before it is entirely ready.
Baselines are represented by a page, with the exception of "instant" baselines (created using the byline icon):
The wizard to create baselines is displayed if you use the button in the "Baselines" tab. You can bypass this wizard when creating the baseline using the blue "Create" button in the top bar.
The wizard tells you not to forget related requirements, and suggests you add them.
On a page, click the "byline", select "Compare" and choose a baseline to compare to. It will highlight modified requirements.
Starting from the "Baselines" tab, choose two baselines and press "Generate diff".
When you view an old version of a page, the detail popup shows the details of the baseline.
It is possible to link an issue to a specific baseline of the requirements. So your client can't change requirements on the fly!
In the JIRA link dialog, click "Baselines".
Tip: If the baselines don't show, it means your administrator has not configured
|Once you've ticked a baseline, search for requirements. Only those in the baseline will display.|
|Tip: If you want to upgrade from one version to the next, click "Update to v4".|
|From JIRA, only use links to baselines when you are writing a bug report about a specific version.||From JIRA, don't link to the baseline of a requirement that you want to evolve. It is much easier to just link to whatever|
the current version is, then let JIRA update it whenever it is updated.
|Don't generally include images in requirements. They are not saved the same way as text is.|
|Don't put too much text in a requirement. Only the title should be in the requirement; the user can click to view it in context. After all, Requirement Yogi is designed around the idea of using pages to describe requirements.|
There is a "Baselines" tab:
There is a special query term: