Skip to content

Specifications for the Real World

"Writing Great Specifications" teaches Gherkin specs creation with SBE, enhancing team collaboration.

3 min read
Specifications for the Real World
room, people, workers, working, whiteboard, yellow stickies
🦉
Before Growth is a weekly column about startups and their builders prior to product–market fit.

Here’s a quick summary of my book, Writing Great Specifications. It 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.

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.

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


🙌
Thanks for being a part of Before Growth! The newsletter has grown mainly through word of mouth. Would you mind sharing it with a couple of friends who might like it too?
ProductManagingEngineering

Kamil Nicieja

I guess you can call me an optimist. I build products for fun—I’m a startup founder, author, and software engineer who’s worked with tech companies around the world.

Comments


Related posts

The Economics of LLMs

How to avoid bankruptcy scaling up large language models

The Economics of LLMs

On a Scale From One to Ten, With No Sevens

Eliminate the safe option.

On a Scale From One to Ten, With No Sevens

Scope is What Kills Founders

Particularly those who are inexperienced.

Scope is What Kills Founders