Example Mapping Quickstart

If you know all about Example Mapping and want to get stuck in then read on. Otherwise feel free to read a little more about Example Mapping.

Open the Example mapping page and you will be presented with a screen like this:

Add your first rule

Click Add Rule at the top right to add your first rule. Enter the rule text in the text area, for example "User can add a ticket to the cart":

The buttons below the rule text allow you to add an example for this rule, or three examples all at once. Click + to create an example and enter the example text "User clicks add to cart on ticket page. Page displays cart with the ticket in it". Note that it is possible to drag on the text area lower right hand corner to increase the size of the text area. Further examples can be added by clicking the buttons below the first example. These will help to drive out further rules.

Add another rule

You may find that some examples you think of won't fit into the rule, and this will be a good time to create a second rule. For instance the example "User selects ten tickets and clicks add to cart, only 5 are now available, user is shown a warning"


A second rule has been created.

You can keep creating examples for rules, and adding further rules until you have mapped out your feature. Examples can be removed by deleting the text and then pressing the backspace key in the example to be deleted. Rules can be removed by clicking the trash can icon at the top right of each rule.

Add questions

During the course of example mapping a feature you will often come up with a question that can't be answered straight away, or a question where you want to capture the answer to enhance the clarity for all stakeholders. Click Add question to add a question below the rules and examples. Here is a sample question and answer:

Questions can removed by clicking the trashcan icon at the top of each question. You can add as many questions as you need.

Complete the Definition of Done

The Definition of Done section can be used to enter metadata about the feature. The available fields are currently pre-defined and include options such as excluded functionality, documentation required, which can be filled in or not as required. In the future these may be configurable.

Export to clipboard

When you have finished mapping your feature you can export it all as markdown. Click Export at the top right, followed by Export to clipboard. All of the rules, examples, questions and definitions entered will be formatted as Markdown and copied to your clipboard.

  Example export:

  # Rules
  ## User can add a ticket to the cart
  * User clicks add to cart on ticket page. Page displays cart with the ticket in it

  ## Ticket availability checked before add to cart
  * User selects ten tickets and clicks add to cart, only 5 are now available, user is shown a warning

  ---

  # Questions:
  What is the maximum number of tickets a user can add at once?


  ---

  # Definition of Done:
  Story Points
  1

  Excluded Functionality
  Removing items from the cart

  Automated testing
  Integration testing of API

  Security
  Check XSS, CSRF etc.

  Deployment / Support into Live
  n/a

  Documentation / Communication
  not required
  

The Markdown can be pasted into a tool that supports Markdown formatting. In future it may be possible to select different text formatting options.

Saving an example mapping session

It is not currently possible to save an example mapping session, but this is something we are working on. Your session is persisted in browser storage though, so you can come back another day to find your session intact. To start a fresh session click the Clear Session button at the top right.

Create an exmaple map

If this tool is helpful, please help by sharing!

© 2017 TeamUp Labs | Privacy policy