Writing Great Specifications

Author: Kamil Nicieja
Publisher: Simon and Schuster
ISBN: 1638353905
Category : Computers
Languages : en
Pages : 449

Book Description
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

Specification by Example

Author: Gojko Adzic
Publisher: Simon and Schuster
ISBN: 1638351368
Category : Computers
Languages : en
Pages : 346

Book Description
Summary Specification by Example is an emerging practice for creating software based on realistic examples, bridging the communication gap between business stakeholders and the dev teams building the software. In this book, author Gojko Adzic distills interviews with successful teams worldwide, sharing how they specify, develop, and deliver software, without defects, in short iterative delivery cycles. About the Technology Specification by Example is a collaborative method for specifying requirements and tests. Seven patterns, fully explored in this book, are key to making the method effective. The method has four main benefits: it produces living, reliable documentation; it defines expectations clearly and makes validation efficient; it reduces rework; and, above all, it assures delivery teams and business stakeholders that the software that's built is right for its purpose. About the Book This book distills from the experience of leading teams worldwide effective ways to specify, test, and deliver software in short, iterative delivery cycles. Case studies in this book range from small web startups to large financial institutions, working in many processes including XP, Scrum, and Kanban. This book is written for developers, testers, analysts, and business people working together to build great software. Purchase of the print book comes with an offer of a free PDF, ePub, and Kindle eBook from Manning. Also available is all code from the book. What's Inside Common process patterns How to avoid bad practices Fitting SBE in your process 50+ case studies =============================================== Table of Contents Part 1 Getting started Part 2 Key process patterns Part 3 Case studies Key benefits Key process patterns Living documentation Initiating the changes Deriving scope from goals Specifying collaboratively Illustrating using examples Refining the specification Automating validation without changing specifications Validating frequently Evolving a documentation system uSwitch RainStor Iowa Student Loan Sabre Airline Solutions ePlan Services Songkick Concluding thoughts

Writing Better Requirements

Author: Ian F. Alexander
Publisher: Addison-Wesley Professional
ISBN: 9780321131638
Category : Computers
Languages : en
Pages : 180

Book Description
Well-written requirements are crucial to systems of all kinds. This text explains and demonstrates exactly what requirements are for, and how to write them. It provides practical techniques and defines key terms, explaining and illustrating to develop the skills of good requirements writing.

Writing Effective Use Cases

Author: Alistair Cockburn
Publisher: Pearson Education
ISBN: 0201702258
Category : Business & Economics
Languages : en
Pages : 301

Book Description
This guide will help readers learn how to employ the significant power of use cases to their software development efforts. It provides a practical methodology, presenting key use case concepts.

Testcraft

Author: Fred Davidson
Publisher: Yale University Press
ISBN: 0300133812
Category : Language Arts & Disciplines
Languages : en
Pages : 159

Book Description
DIVThe creation of language tests is—and should be—a craft that is accessible and doable not only by a few language test experts, but also by many others who are involved in second/foreign language education, say the authors of this clear and timely book. Fred Davidson and Brian Lynch offer language educators a how-to guide for creating tests that reliably measure exactly what they are intended to measure. Classroom teachers, language administrators, and professors of language testing courses will find in this book an easy and flexible approach to language testing as well as the tools they need to develop tests appropriate to their individual needs. Davidson and Lynch explain criterion-related language test development, a process that focuses on the early stages of test development when the criterion to be tested is defined, specifications are established, and items and tasks are written. This process helps clarify the description of what is being measured by a test and enables teachers to give input on test design in any instructional setting. Informed by extensive research in criterion-referenced measurement, this book invites all language educators to participate in the craft of test development and shows them how to go about it./div

The CSI Construction Specifications Practice Guide

Author: Construction Specifications Institute
Publisher: John Wiley & Sons
ISBN: 0470904879
Category : Architecture
Languages : en
Pages : 312

Book Description
The must-have specifications writing reference and essential study aid for the Certified Construction Specifier (CCS) Exam The CSI Practice Guides are a library of comprehensive references specifically and carefully designed for the construction professional. Each book examines important concepts and best practices integral to a particular aspect of the building process. The CSI Construction Specifications Practice Guide is focused on the roles and responsibilities of the specifications professional in meeting the challenges of the changing world of construction. In this volume, guidelines on topics like writing quality construction specifications and product selection are meshed with best practices for managing project information, working with Building Information Modeling (BIM) and Integrated Project Delivery, and writing sustainable design specifications. Other material covered in this guide includes: The Construction Specifications Institute's collected best practices for authoring specifications Specialized guidance on presentation and management of project information in the context of Building Information Modeling and sustainable design Includes access to a password-protected web site with bonus content, including a PDF of the printed book and copies of CSI format documents, such as UniFormat and SectionFormat/PageFormat An authoritative resource for effective written communication of design intent, The CSI Construction Specifications Practice Guide presents construction professionals and students studying for the Certified Construction Specifier (CCS) Exam with a solid foundation for improving their methods of collecting and delivering important specifications data. Serves as an authoritativeresource for effective writing of design intent Includes CSI's best practicesfor authoring specifications Offers specialized guidance on project information in the context of BIM and sustainable design

Construction Specifications Writing

Author: Mark Kalin
Publisher: John Wiley & Sons
ISBN: 1118174380
Category : Architecture
Languages : en
Pages : 530

Book Description
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)

Requirements Writing for System Engineering

Author: George Koelsch
Publisher: Apress
ISBN: 1484220994
Category : Computers
Languages : en
Pages : 409

Book Description
Learn how to create good requirements when designing hardware and software systems. While this book emphasizes writing traditional “shall” statements, it also provides guidance on use case design and creating user stories in support of agile methodologies. The book surveys modeling techniques and various tools that support requirements collection and analysis. You’ll learn to manage requirements, including discussions of document types and digital approaches using spreadsheets, generic databases, and dedicated requirements tools. Good, clear examples are presented, many related to real-world work the author has done during his career. Requirements Writing for System Engineeringantages of different requirements approaches and implement them correctly as your needs evolve. Unlike most requirements books, Requirements Writing for System Engineering teaches writing both hardware and software requirements because many projects include both areas. To exemplify this approach, two example projects are developed throughout the book, one focusing on hardware and the other on software. This book Presents many techniques for capturing requirements. Demonstrates gap analysis to find missing requirements. Shows how to address both software and hardware, as most projects involve both. Provides extensive examples of “shall” statements, user stories, and use cases. Explains how to supplement or replace traditional requirement statements with user stories and use cases that work well in agile development environments What You Will Learn Understand the 14 techniques for capturing all requirements. Address software and hardware needs; because most projects involve both. Ensure all statements meet the 16 attributes of a good requirement. Differentiate the 19 different functional types of requirement, and the 31 non-functional types. Write requirements properly based on extensive examples of good ‘shall’ statements, user stories, and use cases. Employ modeling techniques to mitigate the imprecision of words. Audience Writing Requirements teaches you to write requirements the correct way. It is targeted at the requirements engineer who wants to improve and master his craft. This is also an excellent book from which to teach requirements engineering at the university level. Government organizations at all levels, from Federal to local levels, can use this book to ensure they begin all development projects correctly. As well, contractor companies supporting government development are also excellent audiences for this book.

The Cucumber Book

Author: Matt Wynne
Publisher: Pragmatic Bookshelf
ISBN: 1680504967
Category : Computers
Languages : en
Pages : 450

Book Description
Your customers want rock-solid, bug-free software that does exactly what they expect it to do. Yet they can't always articulate their ideas clearly enough for you to turn them into code. You need Cucumber: a testing, communication, and requirements tool-all rolled into one. All the code in this book is updated for Cucumber 2.4, Rails 5, and RSpec 3.5. Express your customers' wild ideas as a set of clear, executable specifications that everyone on the team can read. Feed those examples into Cucumber and let it guide your development. Build just the right code to keep your customers happy. You can use Cucumber to test almost any system or any platform. Get started by using the core features of Cucumber and working with Cucumber's Gherkin DSL to describe-in plain language-the behavior your customers want from the system. Then write Ruby code that interprets those plain-language specifications and checks them against your application. Next, consolidate the knowledge you've gained with a worked example, where you'll learn more advanced Cucumber techniques, test asynchronous systems, and test systems that use a database. Recipes highlight some of the most difficult and commonly seen situations the authors have helped teams solve. With these patterns and techniques, test Ajax-heavy web applications with Capybara and Selenium, REST web services, Ruby on Rails applications, command-line applications, legacy applications, and more. Written by the creator of Cucumber and the co-founders of Cucumber Ltd., this authoritative guide will give you and your team all the knowledge you need to start using Cucumber with confidence. What You Need: Windows, Mac OS X (with XCode) or Linux, Ruby 1.9.2 and upwards, Cucumber 2.4, Rails 5, and RSpec 3.5

Specification Writing and Management

Author: Max Mcrobb
Publisher: CRC Press
ISBN: 1000147398
Category : Technology & Engineering
Languages : en
Pages : 204

Book Description
This book deals with the fundamentals of specification writing and management. It is useful for anyone concerned with the preparation of standards in a world that is shrinking due to improvement in communication and where many specifications have to hold clarity when translated into other languages.