Writing Great Specifications : Using Specification by Example and Gherkin

Specification by Example and Gherkin offer programmers, designers, and managers an inclusive environment for clear communication, discovering requirements, and building a documentation system.Writing Great Specifications is an example-rich tutorial that teaches readers how to write good Gherkin specification documents that take advantage of Specification by Example’s benefits. Engineers and testers will find it helpful in striking a stronger chord with nontechnical audiences through automated specifications.Key Features: · Teaches good practices to refactor Gherkin documents in legacy projects· Example-rich tutorial· In-depth introductionThis book is a teaching resource for product and design people, programmers and testers. About the Technology: Specification by Example is a collaborative approach to defining and illustrating software requirements using concrete examples. Gherkin is a business-readable DSL that you use to describe software’s behaviour as executable test cases that are easy for non-technical folks to understand.what's inside• Reading and writing Gherkin• Designing story-based test cases• Team Collaboration• Managing a suite of Gherkin documentsabout the readerPrimarily written for developers and architects, this book is accessible to any member of a software design team.about the authorKamil Nicieja is a seasoned engineer, architect, and project manager with deep expertise in Gherkin and SBE. Annotation SummaryWriting Great Specifications 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. Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications. About the TechnologyThe 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. About the BookWriting Great Specifications 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. What's InsideReading and writing GherkinDesigning story-based test casesTeam CollaborationManaging a suite of Gherkin documentsAbout the ReaderPrimarily written for developers and architects, this book is accessible to any member of a software design team. About the AuthorKamil Nicieja is a seasoned engineer, architect, and project manager with deep expertise in Gherkin and SBE. Table of contentsIntroduction to specification by example and GherkinPART 1 - WRITING EXECUTABLE SPECIFICATIONS WITH EXAMPLESThe specification layer and the automation layerMastering the Given-When-Then templateThe basics of scenario outlinesChoosing examples for scenario outlinesThe life cycle of executable specificationsLiving documentationPART 2 - MANAGING SPECIFICATION SUITESOrganizing scenarios into a specification suiteRefactoring features into abilities and business needsBuilding a domain-driven specification suiteManaging large projects with bounded contexts SummaryWriting Great Specifications 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.Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications.About the TechnologyThe 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.About the BookWriting Great Specifications 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. What's InsideReading and writing GherkinDesigning story-based test casesTeam CollaborationManaging a suite of Gherkin documentsAbout the ReaderPrimarily written for developers and architects, this book is accessible to any member of a software design team.About the AuthorKamil Nicieja is a seasoned engineer, architect, and project manager with deep expertise in Gherkin and SBE.Table of contentsIntroduction to specification by example and Gherkin PART 1 - WRITING EXECUTABLE SPECIFICATIONS WITH EXAMPLESThe specification layer and the automation layer Mastering the Given-When-Then template The basics of scenario outlines Choosing examples for scenario outlines The life cycle of executable specifications Living documentation PART 2 - MANAGING SPECIFICATION SUITES Organizing scenarios into a specification suite Refactoring features into abilities and business needs Building a domain-driven specification suite Managing large projects with bounded contexts Specification by Example and Gherkin offer programmers, designers, and managers an inclusive environment for clear communication, discovering requirements, and building a documentation system. __Writing Great Specifications__ is an example-rich tutorial that teaches readers how to write good Gherkin specification documents that take advantage of Specification by Example’s benefits. Engineers and testers will find it helpful in striking a stronger chord with nontechnical audiences through automated specifications. **Key Features:** · Teaches good practices to refactor Gherkin documents in legacy projects · Example-rich tutorial · In-depth introduction This book is a teaching resource for product and design people, programmers and testers. **About the Technology:** Specification by Example is a collaborative approach to defining and illustrating software requirements using concrete examples. Gherkin is a business-readable DSL that you use to describe software’s behaviour as executable test cases that are easy for non-technical folks to understand. Specification by Example and Gherkin offer programmers, designers, and managers an inclusive environment for clear communication, discovering requirements, and building a documentation system. Writing Great Specifications is an example-rich tutorial that teaches readers how to write good Gherkin specification documents that take advantage of Specification by Example's benefits. Engineers and testers will find it helpful in striking a stronger chord with non-technical audiences through automated specifications. Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications.

Writing Great Specifications 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.