Use an Approach Inspired by Domain-Driven Design to Build Documentation That Evolves to Maximize Value Throughout Your Development Lifecycle Software documentation can come to life, stay dynamic, and actually help you build better software. Writing for developers, coding architects, and other software professionals, Living Documentation shows how to create documentation that evolves throughout your entire design and development lifecycle. Through patterns, clarifying illustrations, and concrete examples, Cyrille Martraire demonstrates how to use well-crafted artifacts and automation to dramatically improve the value of documentation at minimal extra cost. Whatever your domain, language, or technologies, you don't have to choose between working software and comprehensive, high-quality documentation: you can have both. · Extract and augment available knowledge, and make it useful through living curation · Automate the creation of documentation and diagrams that evolve as knowledge changes · Use development tools to refactor documentation · Leverage documentation to improve software designs · Introduce living documentation to new and legacy environments

Use an Approach Inspired by Domain-Driven Design to Build Documentation That Evolves to Maximize Value Throughout Your Development Lifecycle Software documentation can come to life, stay dynamic, and actually help you build better software. Writing for developers, coding architects, and other software professionals, Living Documentation shows how to create documentation that evolves throughout your entire design and development lifecycle. Through patterns, clarifying illustrations, and concrete examples, Cyrille Martraire demonstrates how to use well-crafted artifacts and automation to dramatically improve the value of documentation at minimal extra cost. Whatever your domain, language, or technologies, you don’t have to choose between working software and comprehensive, high-quality documentation: you can have both. · Extract and augment available knowledge, and make it useful through living curation · Automate the creation of documentation and diagrams that evolve as knowledge changes · Use development tools to refactor documentation · Leverage documentation to improve software designs · Introduce living documentation to new and legacy environments

Deliver software that does what it’s supposed to do! Behavior-Driven Development guides your software projects to success with collaboration, communication techniques, and concrete requirements you can turn into automated tests. In BDD in Action, Second Edition you’ll learn how to: Implement and improve BDD practices Prioritize features from business goals Facilitate an example mapping session Write automated acceptance tests Scale up your automated acceptance tests Deliver accurate reporting and documentation Around half of all software projects fail to deliver on requirements. Behavior-Driven Development (BDD) helps make sure that yours isn’t one of them. Behavior-Driven Development in Action, Second Edition teaches you how to ensure that everyone involved in a software project—from developers to non-technical stakeholders—are in agreement on goals and objectives. It lays out the communication skills, collaborative practices, and useful automation tools that will let you seamlessly succeed with BDD. Now in its second edition, this revised bestseller has been extensively updated with new techniques for incorporating BDD into large-scale and enterprise development practices such as Agile and DevOps. Foreword by Daniel Terhorst-North. Purchase of the print book includes a free eBook in PDF, Kindle, and ePub formats from Manning Publications. About the Technology Behavior-Driven Development is a collaborative software design technique that organizes examples of an application’s desired behavior into a concrete, testable specification. Because the BDD process gathers input from all areas of an organization, it maximizes the likelihood your software will satisfy both end users and business stakeholders. The established collaboration practices and automation strategies in this book will help you maximize the benefits of BDD for your dev team and your business clients. About the Book In BDD in Action, Second Edition, you’ll learn to seamlessly integrate BDD into your existing development process. This thoroughly revised new edition now shows how to integrate BDD with DevOps and large-scale Agile systems. Practical examples introduce cross-functional team communication skills, leading a successful requirements analysis, and how to set up automated acceptance criteria. What’s Inside How BDD positively affects teamwork, dynamics, and collaboration with stakeholders Help teams discover and analyze requirements, uncover assumptions, and reduce risks Make acceptance, integration, and unit testing more effective Automate reporting and living documentation to improve transparency About the Reader For all development teams. No experience with BDD required. Examples in Java, JavaScript, and TypeScript can be easily expressed in your chosen language. About the Author John Ferguson Smart is the creator of the Serenity BDD framework and founder of the Serenity Dojo training school. Jan Molak is the author of the Serenity/JS testing framework, Jenkins Build Monitor, and other CD and testing tools. Table of Contents PART 1 - FIRST STEPS 1 Building software that makes a difference 2 Introducing Behavior-Driven Development 3 BDD: The whirlwind tour PART 2 - WHAT DO I WANT? DEFINING REQUIREMENTS USING BDD 4 Speculate: From business goals to prioritized features 5 Describing and prioritizing features 6 Illustrating features with examples 7 From examples to executable specifications PART 3 - HOW DO I BUILD IT? CODING THE BDD WAY 8 From executable specifications to automated acceptance tests 9 Writing solid automated acceptance tests 10 Automating acceptance criteria for the UI layer 11 Test automation design patterns for the UI layer 12 Scalable test automation with the Screenplay Pattern 13 BDD and executable specifications for microservices and APIs 14 Executable specifications for existing systems with Serenity/JS 15 Portable test automation with Serenity/JS 16 Living documentation and release evidence

Master BDD to deliver higher-value software more quickly To develop high-value products quickly, software development teams need better ways to collaborate. Agile methods like Scrum and Kanban are helpful, but they’re not enough. Teams need better ways to work inside each sprint or work item. Behavior-driven development (BDD) adds just enough structure for product experts, testers, and developers to collaborate more effectively. Drawing on extensive experience helping teams adopt BDD, Richard Lawrence and Paul Rayner show how to explore changes in system behavior with examples through conversations, how to capture your examples in expressive language, and how to flow the results into effective automated testing with Cucumber. Where most BDD resources focus on test automation, this guide goes deep into how BDD changes team collaboration and what that collaboration looks like day to day. Concrete examples and practical advice will prepare you to succeed with BDD, whatever your context or role. · Learn how to collaborate better by using concrete examples of system behavior · Identify your project’s meaningful increment of value so you’re always working on something important · Begin experimenting with BDD slowly and at low risk · Move smoothly from informal examples to automated tests in Cucumber · Use BDD to deliver more frequently with greater visibility · Make Cucumber scenarios more expressive to ensure you’re building the right thing · Grow a Cucumber suite that acts as high-value living documentation · Sustainably work with complex scenario data · Get beyond the “mini-waterfalls” that often arise on Scrum teams

The concept of the Constitution as a living document refers to its ability to adapt and evolve over time to meet the changing needs, values, and aspirations of society. Here’s an exploration of what it means for the Constitution to be a living document: Characteristics of a Living Document: Flexibility and Adaptability: A living Constitution is flexible enough to accommodate changes through amendments and interpretations that reflect societal progress, technological advancements, and evolving norms. Interpretative Nature: Courts play a crucial role in interpreting constitutional provisions in the context of contemporary issues and challenges. Judicial interpretation ensures that constitutional principles remain relevant and applicable to modern circumstances. Inclusivity and Democratic Principles: The living Constitution reflects democratic principles by ensuring inclusivity, protecting fundamental rights, and promoting equality. Amendments and interpretations aim to enhance these principles over time. Balancing Stability and Change: While it evolves, a living Constitution maintains a balance between stability (core principles and values) and change (adaptations to new realities), ensuring continuity in governance and legal framework. Examples of Constitutional Evolution: Amendments: The Constitution of India has been amended several times to address emerging issues such as citizenship, reservation policies, and electoral reforms. These amendments reflect changing societal needs and legislative priorities. Judicial Interpretation: Landmark judicial decisions, such as expanding the scope of fundamental rights or reinterpreting constitutional provisions considering contemporary challenges (like environmental protection or privacy rights), illustrate the dynamic nature of the Constitution. Social Reforms: Movements for social justice, gender equality, and minority rights have influenced constitutional amendments and interpretations, leading to reforms that uphold these values and address historical injustices. Importance of a Living Constitution: Relevance and Responsiveness: By adapting to new circumstances and societal changes, a living Constitution remains relevant and responsive, maintaining public confidence in its ability to address current issues and protect rights. Democratic Legitimacy: The ability to evolve through democratic processes, including legislative amendments and judicial review, enhances the legitimacy of the Constitution by reflecting the will and aspirations of the people. Legal Stability: While dynamic, a living Constitution provides a stable legal framework that guides governance and protects fundamental rights, fostering a predictable environment for legal and political institutions. Challenges and Criticisms: Judicial Activism vs. Restraint: Debates often arise over the extent of judicial activism in interpreting the Constitution, with critics arguing for judicial restraint to preserve legislative intent and separation of powers. Interpretive Disputes: Disagreements can occur over the interpretation of constitutional provisions, leading to political and legal controversies that test the boundaries of constitutional principles. Conclusion: The concept of the Constitution as a living document underscores its capacity to grow and adapt in response to societal changes while upholding fundamental principles and rights. In India and other democracies, this concept ensures that constitutional governance remains dynamic, inclusive, and responsive to the evolving needs and aspirations of diverse populations. Balancing stability with adaptation through amendments, judicial interpretations, and societal reforms ensures that the Constitution continues to serve as a cornerstone of democratic governance and rule of law.

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