Writing Great Specifications: Using Specification By Example and Gherkin

Writing Great Specifications: Using Specification By Example and Gherkin

<div><p><b>Summary</b></p> <p><i>Writing Great Specifications</i> is an example-rich tutorial that teaches you how to write good Gherkin specification documents that take advantage of the benefits of specification by example. Foreword written by Gojko Adzic.</p> <p>Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications.</p> <p><b>About the Technology</b></p> <p>The clearest way to communicate a software specification is to provide examples of how it should work. Turning these story-based descriptions into a well-organized dev plan is another matter. Gherkin is a human-friendly, jargon-free language for documenting a suite of examples as an executable specification. It fosters efficient collaboration between business and dev teams, and it's an excellent foundation for the specification by example (SBE) process.</p> <p><b>About the Book</b></p> <p><i>Writing Great Specifications</i> teaches you how to capture executable software designs in Gherkin following the SBE method. Written for both developers and non-technical team members, this practical book starts with collecting individual feature stories and organizing them into a full, testable spec. You'll learn to choose the best scenarios, write them in a way that anyone can understand, and ensure they can be easily updated by anyone.management. </p> <p><b>What's Inside</b></p> <p/><ul><li>Reading and writing Gherkin</li><li>Designing story-based test cases</li><li>Team Collaboration</li><li>Managing a suite of Gherkin documents</li></ul> <p><b>About the Reader</b></p> <p>Primarily written for developers and architects, this book is accessible to any member of a software design team.</p> <p><b>About the Author</b></p> <p><b>Kamil Nicieja</b> is a seasoned engineer, architect, and project manager with deep expertise in Gherkin and SBE.</p> <p><b>Table of contents</b></p> <p/><ol><li>Introduction to specification by example and Gherkin </li><h4>PART 1 - WRITING EXECUTABLE SPECIFICATIONS WITH EXAMPLES</h4><li>The specification layer and the automation layer </li><li>Mastering the Given-When-Then template </li><li>The basics of scenario outlines </li><li>Choosing examples for scenario outlines </li><li>The life cycle of executable specifications </li><li>Living documentation </li><h4>PART 2 - MANAGING SPECIFICATION SUITES </h4><li>Organizing scenarios into a specification suite </li><li>Refactoring features into abilities and business needs </li><li>Building a domain-driven specification suite </li><li>Managing large projects with bounded contexts </li></ol></div>