Living Documentation by design, with Domain-Driven Design
Living Documentation by design, with Domain-Driven Design
Living Documentation by design, with Domain-Driven Design

This book is 100% complete

Completed on 2017-03-28

About the Book

You don't necessarily have to chose between Working Software and Extensive Documentation!

The approach "Specification by Example" has introduced the idea of a "Living Documentation". In this approach, examples of behavior are used for documentation and are also promoted into automated tests. Whenever a test fails, it signals the documentation is no longer in sync with the code so it can just be fixed quickly.

This has shown that it is possible to have useful documentation that doesn't suffer the fate of getting obsolete once written.

But we can go much further. This book expands on this idea of a Living Documentation. It shows how a living documentation evolves at the same pace than the code, for all aspects of a project, from the business goals to the business domain knowledge, architecture and design, processes and deployment.

This book explains the theory and describes a number of techniques, with illustrations and concrete examples. You will learn how to start investing into documentation that is always up to date, at a minimal extra cost thanks to well-crafted artifacts and the use of automation.

This book is not totally finished yet. Upgrades until the book is completed will of course be free!

About the Author

Cyrille Martraire
Cyrille Martraire

Cyrille Martraire is a passionate developer since 1999. He's the co-founder and CTO of Arolla, a company specializing in software development and nothing else. With a love-and-hate relationship with documentation, he has experimented over more than 10 years with multiple ways to get smarter documentation, from automation to self-discipline.

Addicted to development at all scales, Cyrille still dedicates a large part of his energy for clients, hands-on in the code, yet also deeply involved in enterprise architecture or business analysis in finance. Passionate about design in every aspect (TDD, BDD, DDD), he also founded the Paris Software Craftsmanship community. Cyrille is a regular speaker in conferences in Europe and in other continents as well.

The Leanpub 45-day 100% Happiness Guarantee

Within 45 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms...

Write and Publish on Leanpub

Authors and publishers use Leanpub to publish amazing in-progress and completed ebooks, just like this one. You can use Leanpub to write, publish and sell your book as well! Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks. Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. It really is that easy.

Learn more about writing on Leanpub