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 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 Essential Writer's Notebook

Author:
Publisher: Peter Pauper Press, Inc.
ISBN: 9780880882439
Category : Authorship
Languages : en
Pages : 172

Book Description
This beautiful notebook, illustrated by the author's own paintings, provides the perfect opportunity for would-be writers, as well as those seeking a fresh approach to their work, to learn simple techniques that will help them master the basics of the craft. Inspired by the philosophy of Zen Buddhism, the book provides a complete step-by-step mini-course on how to write clearly and powerfully. Abundant lined pages can be used for writing practice.

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

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 CSI Project Delivery Practice Guide

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

Book Description
Get the must-have reference on standards and best practices for the delivery of a construction project. The CSI Practice Guides are a library of comprehensive references specifi cally and carefully designed for the construction professional. Each book examines important concepts and best practices integral to a particular aspect of the construction process. Laying the foundation for this series, The CSI Project Delivery Practice Guide provides fundamental knowledge for the documentation, administration, and successful delivery of construction projects. It also serves as the pivotal starting point for understanding CSI's core values, as well as a useful study aid for those wishing to obtain the Construction Documents Technologist certificate. This easy-to-follow guide: Is a great introduction to the construction process for the new practitioner. Functions as a ready reference for the experienced construction professional. Packaged with the book is an access code which allows access to a password-protected web site with bonus content, including a PDF of the printed book and samples of CSI format documents, such as UniFormat and SectionFormat/PageFormat. The CSI Project Delivery Practice Guide offers general information all construction professionals need for understanding their roles in the delivery of a construction project. Key principles are presented and discussed in detail to allow the reader to take full advantage of material covered in depth by the more specialized CSI Practice Guides. If you can own only one Practice Guide, this is the one to get.

Code Craft

Author: Pete Goodliffe
Publisher: No Starch Press
ISBN: 1593271190
Category : Computers
Languages : en
Pages : 626

Book Description
A guide to writing computer code covers such topics as variable naming, presentation style, error handling, and security.

The Book Proposal Book

Author: Laura Portwood-Stacer
Publisher: Princeton University Press
ISBN: 0691216622
Category : Education
Languages : en
Pages : 210

Book Description
A step-by-step guide to crafting a compelling scholarly book proposal—and seeing your book through to successful publication The scholarly book proposal may be academia’s most mysterious genre. You have to write one to get published, but most scholars receive no training on how to do so—and you may have never even seen a proposal before you’re expected to produce your own. The Book Proposal Book cuts through the mystery and guides prospective authors step by step through the process of crafting a compelling proposal and pitching it to university presses and other academic publishers. Laura Portwood-Stacer, an experienced developmental editor and publishing consultant for academic authors, shows how to select the right presses to target, identify audiences and competing titles, and write a project description that will grab the attention of editors—breaking the entire process into discrete, manageable tasks. The book features over fifty time-tested tips to make your proposal stand out; sample prospectuses, a letter of inquiry, and a response to reader reports from real authors; optional worksheets and checklists; answers to dozens of the most common questions about the scholarly publishing process; and much, much more. Whether you’re hoping to publish your first book or you’re a seasoned author with an unfinished proposal languishing on your hard drive, The Book Proposal Book provides honest, empathetic, and invaluable advice on how to overcome common sticking points and get your book published. It also shows why, far from being merely a hurdle to clear, a well-conceived proposal can help lead to an outstanding book.