O'Reilly logo

Writing Great Specifications: Using Specification by Example and Gherkin by Kamil Nicieja

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Best practices in the book

Best practice

Section

Don’t let agile be an excuse to ignore documentation. 1.3.3
Don’t let documentation replace communication. 1.3.2
Derive scope from goals. 1.5.1
Illustrate requirements with examples. 1.5.2
Specify collaboratively. 1.5.3, 7.4
Validate frequently. 1.6.2
Capture behavioral requirements with scenarios. 2.2.2
Gather examples from the real world. 3.1.2
Favor specifying intentions and outcomes over user interface. 3.1.3
Start writing scenarios with the Then keyword. 3.2.1
Aim for one When keyword per scenario. 3.2.3
Don’t use backgrounds. 3.2.3
Aim for as few Givens, Whens, and Thens as possible. 3.2.4
Refactor redundant scenarios with scenario outlines. 4.2.2 ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required