Fold Note Groups
- Dmytro Stasyuk
It is often easier to navigate the feature and to perform drag & drop operations by first folding note groups. This is particularly useful in Features with many notes.
To fold a note group, simply select it and press either “Alt+Enter“ keyboard shortcut or hold the “Alt“ key while clicking the note’s drag handle with the left mouse button.
The folded summary is shown to the right of the folded note. It provides a quick visual indication of how many notes have been folded. Hovering over it with the mouse will show a tooltip with the number of individual notes or note groups that have been folded. Clicking on the folded summary will unfold the note group.
Fold User Stories
Folding User Story note group is useful when you want to quickly capture a newly discovered User Story under the same Feature during team discussions.
Fold Rules
Folding Rule note groups can be useful whenever you just want to quickly review the acceptance criteria for a User Story (note that Rules in a Cucumber Feature file essentially are the acceptance criteria), without going into the details of the examples.
Fold all rules
Click on the toolbar button highlighted below while holding the ‘Alt’ key in order to fold all of the Rules in one operation
Click on the chevron double-down button next to it while holding the ‘Alt’ key to unfold all of the Rules
Fold Scenarios
Folding Scenario note groups can be useful when you don’t want to see the details of each of the examples especially when you are working also with the Step notes, as is the case with Feature Mapping.
Fold all scenarios
Click on the toolbar button highlighted below in order to fold all of the Scenarios in one operation
Click on the chevron double-down button next to it to unfold all of the Scenarios
Fold on Page Load
You can configure the Feature panel to have User Story, Rule or Scenario note groups folded every time the issue page loads. This can be useful if you wish to be presented with less information initially and then click to unfold only when you want to see the details.
This can be configured via the preferences menu option highlighted below.
* Note that the “Feature” fold option shown in the screenshot above corresponds to folding the User Story note groups - since the user story text is placed at the Feature cucumber keyword when viewed as a plain text file.
Folding is Linked to Gherkin Text Editor Mode
Folding can be done either via Example Mapping mode or via the Gherkin Text Editor mode. The folded ranges are “linked“ between the two modes - meaning that if you fold a section of lines in Gherkin Text Editor then the corresponding note groups in Example Mapping will get folded also. This can be better seen when viewing the two modes in a side-by-side view, like shown below.
Selected Scenario Note Group above corresponds to line number 9 in the Gherkin Text Editor panel on the right which has been folded.