You need to enable JavaScript in order to use the AI chatbot tool powered by ChatBot

Working Software Over Comprehensive Documentation

Why I Advocate ‘Working Software Over Comprehensive Documentation’ in Agile🚀

Allow me to ask you an important question “Have you ever purchased a product solely because its documentation was immaculate, not caring about its functionality or value?

I bet you’re struggling to recall such an instance. I cannot imagine a single example in my many years of leading Scrum and Agile teams. If you can think of such an occasion, I’d love to hear it!

So, this brings me to ask a second question, ‘Have you ever been left scratching your head about the Agile Manifesto’s assertion for “Working Software Over Comprehensive Documentation”? 🤔

It’s a phrase that I’ve been asked to explain countless times, and it’s a value that can sometimes feel counter-intuitive.

So, let’s take a moment to delve into it. 📚🖥️

Breaking Down the Myths: Documentation in Agile

What we’re talking about in working software over comprehensive documentation is certainly not getting rid of documentation. As such, it’s striking the balance of having enough documentation to run your product and your organisation responsibly.

In truth, “Working Software Over Comprehensive Documentation” doesn’t mean discarding documentation altogether. It’s about achieving a balance 🧘‍♀️

It’s about having just enough documentation to operate your product and run your organisation responsibly.

A New Perspective: Documentation as an Aid, Not the Star

But here’s the key insight 💡: Customers are not buying your product for its detailed documentation. They care about the outcome, the benefits, and the needs your product meets – the working software.

Now let’s look at the documentation from this perspective: It’s a tool that helps users achieve what they need from the product. But the documentation should never overshadow the primary goal – delivering a product that works, provides value, and meets user needs.

So let’s not lose sight of the core focus in our agile endeavours – delivering working, valuable software while using documentation as a supportive tool. Keep your product at the forefront, your user’s needs paramount, and let’s build software that speaks for itself!

If you’ve enjoyed my insights and want to dive deeper into Agile principles, look at some of the courses available to shape your Agile future!

Thank you for being part of our Agile journey! 💪💼💡

If you are interested in becoming an agile coach and value mentored, coach-driven skills development in your journey to mastery, visit our Growing Agile Coaches page.

If you are inspired by the idea of an online apprenticeship for a scrum master, visit

If you like the idea of becoming a scrum master and want to achieve internationally recognised and certified accreditation as a scrum master, visit our Certified Scrum Master (CSM) course page.

If you are already a scrum master and want to upskill to a more advanced level of knowledge and agile coaching capability, visit our Advanced Certified Scrum Master (A-CSM) course page.

If you have several years’ experience as a scrum master and want to validate and certify your professional skills, visit our Certified Scrum Professional Scrum Master (CSP-SM) course page.

For more information on John McFadyen, visit or connect with John on LinkedIn at

#agile #agilecoach #agilecoaching #agileprojectmanagement #agileproductdevelopment #agility #businessagility #scrum #scrummaster #scrumtraining #scrumcertification #scrumalliance #agilecentre #johnmcfadyen #coach #coaching #certifiedscrummaster

Keywords: Agile Manifesto, Working Software, Comprehensive Documentation, Balance.

Hashtags: #Scrummaster #AgileMethodology #ProductDevelopment


#Agile, #AgileCoach, #Scrum, #ScrumMaster, #AgileCentre, #ProductOwner, #BusinessAnalyst, #AgileProjectManagement, #BusinessAgility, #ScrumTraining, #AgileProductDevelopment.

author avatar
John McFadyen Managing Partner
John McFadyen is an Executive and Enterprise Agile Coach with proven experience working on some of the UK and Europe’s largest, most complex Agile Transformations. As a Certified Scrum Trainer, John brings a wealth of experience as an Agile coach, Agile practitioner and software developer into each of the four core courses he provides. The war stories, the insights into successful Agile transformations and everything he has learned from coaching high-performance Agile teams combine to provide course delegates with a unique, compelling training experience that transforms as much as it empowers.

Like this post? Share with friends & colleagues using the share buttons below.


Related Blog Posts

Deploy + Improve Scrum
John McFadyen
Deploy + Improve Scrum
John McFadyen
Deploy + Improve Scrum
John McFadyen
Deploy + Improve Scrum
John McFadyen