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 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.