liveBook · Manning

Example Mapping

As explained in BDD in Action, Second Edition

Example Mapping is a collaborative BDD technique for exploring rules, examples, and questions about a requirement.

Example Mapping is a collaborative, visual technique for turning a User Story into shared understanding of its business rules, examples, counterexamples, and unresolved questions. It keeps requirements conversations focused when assumptions, missing details, or competing interpretations threaten delivery. section 6.0 section 6.4

Run a session by arranging four kinds of cards:

  • Place the User Story on a yellow card at the top of the map. section 6.4.1
  • Record business rules or acceptance criteria on blue cards beneath the story. section 6.4.1
  • Add concrete examples and counterexamples on green cards connected to each rule. section 6.4
  • Capture unanswered assumptions and uncertainties on pink question cards. section 6.4
  • Timebox the conversation to roughly 25–30 minutes, then decide whether the story is understood well enough to start or needs another session. section 6.4.5

Frequent-flyer points

For a points-earning User Story, the team records rules such as “Flights within Europe earn 100 points,” “Flights outside Europe earn 1 point per 10 km,” and “Business flights earn an extra 50%.” The team then explores examples, counterexamples, and questions before converting key examples into Given–When–Then scenarios. section 6.4.1 section 6.4.5

Table 6.1 The different types of cards used during Example Mapping (view table figure)

Card

Description

Color

Example

User Story

The feature or User Story under discussion

Yellow

Business rule

Constraints or known acceptance criteria related to the User Story

Blue

Example

Concrete examples and counterexamples of the business rule

Green

Question

Uncertainty or assumptions that cannot be answered or confirmed during the session

Pink

Use the card reference to distinguish the User Story, business rules, examples, and questions while building a map. section 6.4

How BDD in Action, Second Edition covers it

How deep it goes
Explores requirements breadth-first and superficially, deferring detailed examples and Given–When–Then formulation to a later phase.
Examples
Uses train-trip scheduling and frequent-flyer points to illustrate rules, examples, counterexamples, and acceptance criteria.
What it assumes
Starts from a User Story and teaches participants to identify rules, examples, counterexamples, and unanswered questions collaboratively.
What you can do after
Apply it to rapidly enumerate rules and decide whether a User Story is understood enough to begin work or needs further discovery.
How it connects
Connects User Stories, acceptance criteria, BDD, executable specifications, Feature Mapping, and Given–When–Then scenarios.

Also explained in

Compare how 3 books explain Example Mapping →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of BDD in Action, Second Edition. The section links point to the parts of the book it draws on.