Writing Great Specifications

Summary 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. 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 Technology 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. About the Book 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.management. What's Inside Reading and writing Gherkin Designing story-based test cases Team Collaboration Managing a suite of Gherkin documents About the Reader Primarily written for developers and architects, this book is accessible to any member of a software design team. About the Author Kamil Nicieja is a seasoned engineer, architect, and project manager with deep expertise in Gherkin and SBE. Table of contents Introduction to specification by example and Gherkin PART 1 - WRITING EXECUTABLE SPECIFICATIONS WITH EXAMPLES The 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

Updated edition of the comprehensive rulebook to the specifier's craft With this latest update, Construction Specifications Writing, Sixth Edition continues to claim distinction as the foremost text on construction specifications. This mainstay in the field offers comprehensive, practical, and professional guidance to understanding the purposes and processes for preparation of construction specifications. This new edition uses real-world document examples that reflect current writing practices shaped by the well-established principles and requirements of major professional associations, including the American Institute of Architects (AIA), the Engineers Joint Contract Documents Committee (EJCDC), and the Construction Specifications Institute (CSI). Also included are guidelines for correct terminology, product selection, organization of specifications according to recognized CSI formats, and practical techniques for document production. Fully revised throughout, this Sixth Edition includes: Updates to MasterFormat 2004, as well as SectionFormat/PageFormat 2007 and Uniformat End-of-chapter questions and specification-writing exercises Samples of the newly updated construction documents from the AIA New chapter on sustainable design and specifications for LEED projects Updated information on the role of specifications in Building Information Modeling (BIM)

This concise guide to technical specifications leads the reader through the process of writing these instructions, with clear advice to help the student and professional avoid legal disputes or the problems caused by poor drafting.

This flexible textbook provides an integrated approach to user experience (UX) writing and equips students and practitioners with the essential principles and methods to succeed in writing for UX. The fundamental goal of UX writing is to produce usable and attractive content that boosts user engagement and business growth. This book teaches writers how to create content that helps users perform desired tasks while serving business needs. It is informed by user-centered design, content strategy, artificial intelligence (AI), and digital marketing communication methodologies, along with UX-related practices. By combining writing-as-design and design-as-writing, the book offers a new perspective for technical communication education where UX design and writing are merged to achieve effective and desirable outcomes. Outlining the key principles and theories for writing user-centered content design, this core textbook is fundamental reading for students and early career practitioners in UX, technical communication, digital marketing, and other areas of professional writing.