To switch into Example Mapping mode use the buttons in the footer section of the editor panel highlighted below
* Note that in the Data Center version of the app the mode buttons are located on the left and the Save & Cancel buttons on the right
Slide Out Panel for New Notes
Use the toolbar button highlighted below to show or hide the panel which contains new note stacks. Here you can capture description of new Rules, Scenarios etc. and then drag the notes to the right.
Once the notes have been dragged to the right they become part of the Feature file and are persisted when you press the Save button.
Always show new Story notes
By default new notes stack for User Stories gets hidden once you have dragged over at least one user story note to the right. It can however be made always visible via the editor option menu highlighted below.
This can be useful when you need to split the current user story into further separate stories. You can temporarily capture the newly split story onto another User Story note card in the current Feature before creating a new Jira issue and moving it there under its own Feature panel.
Slide out from the right
The new notes panel can be configured to slide out from the right rather than from the left using the menu option highlighted below
Drag & Drop Notes
Place the mouse cursor at the bottom of any note so that the note’s drag handle becomes visible. Then click and hold the left mouse button to “grab” the note. Move it with the mouse to the desired location and then release the mouse button to drop the note.
The locations where a particular note can be dropped is colour highlighted when the note is dragged over it. The note will be auto aligned after dropping so you don’t need to be precise with positioning. Where exactly each type of note can be dropped is explained in the following sections.
Dropping User Story Notes
User Story notes are top level elements and can be dropped onto an empty space or next to other User Story notes dropped earlier.
More than one User Story note
At times you might discover another User Story not previously known as part of your team’s Example Mapping discussions. When this happens it is useful to be able to capture it quickly under the same feature so that it doesn’t get lost and then later after the meeting move it out into its own Jira issue and Feature panel.
Dropping Rule Notes
Rule notes can be dropped onto a User Story note that doesn’t yet have any Rule notes
Or next to other Rule notes dropped earlier
Or onto a User Story note that is currently folded (see Fold Note Groups)
Dropping Scenario Notes
Scenario notes can be dropped onto a Rule note that doesn’t yet have any Scenario notes
Or next to other Scenario notes dropped earlier
Or onto a Rule note that is currently folded
Story scenarios
Cucumber syntax supports having Scenarios without a preceding Rule, so you can also drop a Scenario note directly onto a Story note
See below for difference between a Scenario that belongs to a User Story vs a Scenario that belongs to a Rule
Dropping Question Notes
Semantically questions can belong to User Stories, Rules or Scenarios, so you can drop them accordingly
You can also drop a Question note onto Story, Rule or Scenario note that is currently folded
Dropping Step Notes
Unhide Step notes
Step notes are hidden by default, but they can be made visible by unchecking the editor menu option shown below
Step notes can be dropped onto folded Scenario notes or next to other Scenario steps or question notes like shown below
Steps & questions mixed
Step and question notes that belong to a Scenario can be arranged in any order like shown in example below
Copy & Paste
Copying and pasting notes is performed intuitively using the traditional “Ctrl+C” & “Ctrl+V” keyboard shortcuts respectively (“Command+C” & “Command+V” on MacOS).
Copy and Paste Single Notes
To copy a single note simply select it and press “Ctrl+C”
Then select the note after which you would like to paste the copied note and press “Ctrl+V“
Copy & Paste Note Groups
You can copy all of the notes under Story, Rule or Scenario groups together in one operation. Simply select the group and press “Ctrl+C”
Select the note after which you’d like to paste the copied note group and press “Ctrl+V” to paste
Copy & Paste Between Jira Issues
The contents of copied notes is stored in the standard clipboard, which means you can copy and paste notes and note groups between Features of different Jira issues.
Copy & Paste Into External Editors
The content of a single note or a note group is copied as plain text, which means you can paste it into external editors, e.g. IDEs, notepads, etc.
0 Comments