Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

To switch into Example Mapping mode use the buttons in the footer section of the editor panel highlighted below

image-20241011-114650.png

* 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.

image-20241011-090303.png

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.

image-20241011-091307.png

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.

image-20241011-094422.png

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

image-20241011-113806.png

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.

image-20241011-121159.png

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.

image-20241011-121841.png

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.

image-20241011-122953.png

Dropping Rule Notes

Rule notes can be dropped onto a User Story note that doesn’t yet have any Rule notes

image-20241011-125314.png

Or next to other Rule notes dropped earlier

image-20241011-124356.png

Or onto a User Story note that is currently folded (see Fold Note Groups)

image-20241011-124623.png

Dropping Scenario Notes

Scenario notes can be dropped onto a Rule note that doesn’t yet have any Scenario notes

image-20241011-125456.png

Or next to other Scenario notes dropped earlier

image-20241011-130633.png

Or onto a Rule note that is currently folded

image-20241011-143046.png

Story scenarios
Cucumber syntax supports having Scenarios without a preceding Rule, so you can also drop a Scenario note directly onto a Story note

image-20241011-143845.png

See below for difference between a Scenario that belongs to a User Story vs a Scenario that belongs to a Rule

image-20241011-144728.png

Dropping Question Notes

Semantically questions can belong to User Stories, Rules or Scenarios, so you can drop them accordingly

image-20241011-150034.png

You can also drop a Question note onto Story, Rule or Scenario note that is currently folded

image-20241011-150249.png

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

image-20241011-150730.png

Step notes can be dropped onto folded Scenario notes or next to other Scenario steps or question notes like shown below

image-20241011-151007.png

Steps & questions mixed

Step and question notes that belong to a Scenario can be arranged in any order like shown in example below

image-20241011-151608.png

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”

image-20241011-161942.png

Then select the note after which you would like to paste the copied note and press “Ctrl+V“

image-20241011-162203.png

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”

image-20241011-163238.png

Select the note after which you’d like to paste the copied note group and press “Ctrl+V” to paste

image-20241011-163526.png

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.

image-20241011-165132.png
image-20241002-172336.pngimage-20241002-172350.png
image-20241011-165452.png

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.

image-20241011-165758.png
image-20241002-172336.pngimage-20241002-172350.png
image-20241011-170119.png

  • No labels