liveBook · Manning

Shared understanding

As explained in BDD in Action, Second Edition

A common and sufficiently detailed interpretation of requirements, behavior, and value held by the people collaborating on a product.

A request to transfer funds overseas can sound clear until the team asks which exchange rate to show, when to calculate fees, and how long to guarantee a quoted rate. Those answers affect user experience, implementation, cost, and even what the requested feature should be. Shared understanding means business stakeholders, analysts, testers, and developers work through such questions together rather than passing a specification from one group to the next. section 2.3.2

In Behavior-Driven Development (BDD), conversations about business goals, rules, examples, and counterexamples build a common view of what users need and how a feature should behave. Stakeholder feedback matters throughout: requirements may be incomplete, and a proposed solution may not be the best way to deliver the underlying value. section 1.0 section 2.5.1 section 4.2.8

A practical route from a request to agreed behavior is:

  • Ask why the feature matters, so the team can consider other ways to meet the same business goal. section 4.2.8
  • Discuss concrete cases with stakeholders and domain experts; seek further examples that challenge or extend the emerging rule. section 6.2
  • Express settled examples as readable Given–When–Then scenarios. They can become executable specifications and living documentation, but the notation should support the conversation, not replace it. section 7.0

A password rule that needs a conversation

A registration story initially calls for eight characters, a digit, punctuation, and an error message for insecure passwords. That still leaves open whether letter case or digit position matters and how specific the error should be. Discussing actual passwords with the systems administrator exposes those ambiguities and helps the team agree on observable acceptance criteria. section 6.2

Password

Strength

Acceptable

secret

Weak

No

password

Weak

No

password1

Weak

No

aBcdEfg1

Weak

No

qwertY12

Weak

No

dJeZDip1

Medium

Yes

SeagullHedgehog

Strong

Yes

SeagullHedgehogCatapult

Very strong

Yes

The password table pairs concrete inputs with strength and acceptability judgments. Comparing cases gives the team something more precise to discuss than a vague instruction to require a secure password. section 6.2

The payoff is common ownership of both the problem and the solution. A team that understands the goal can propose alternatives, respond when a solution proves costly, and write specifications stakeholders can review before behavior is automated. section 2.3.2 section 4.2.8 section 7.0

How BDD in Action, Second Edition covers it

How deep it goes
Works through ambiguous password criteria and a conversation-to-scenario process; defers Java automation.
Examples
Uses overseas-transfer design questions and password-strength cases to expose assumptions that an initial feature request or acceptance criteria leave unresolved.
What it assumes
Builds on user stories and acceptance criteria, while introducing Given–When–Then as a notation team members can read together.
What you can do after
Practice/perform cross-functional example conversations, clarify expected behavior, and express agreed examples as scenarios suitable for automation.
How it connects
Links business goals and acceptance criteria to Given–When–Then scenarios, executable specifications, and automated acceptance tests.

Also explained in

Compare how 2 books explain shared understanding →

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.