Search a title or topic

Over 20 million podcasts, powered by 

Player FM logo
Artwork

Content provided by John McFadyen. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by John McFadyen or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://podcastplayer.com/legal.
Player FM - Podcast App
Go offline with the Player FM app!

Working Software Over Comprehensive Documentation

0:54
 
Share
 

Manage episode 383584621 series 3418572
Content provided by John McFadyen. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by John McFadyen or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://podcastplayer.com/legal.

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. 📚🖥️

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.

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 https://www.agilesuccess.academy/courses/growing-scrum-masters-advanced

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.

Breaking Down the Myths: Documentation in AgileA New Perspective: Documentation as an Aid, Not the Star

  continue reading

344 episodes

Artwork
iconShare
 
Manage episode 383584621 series 3418572
Content provided by John McFadyen. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by John McFadyen or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://podcastplayer.com/legal.

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. 📚🖥️

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.

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 https://www.agilesuccess.academy/courses/growing-scrum-masters-advanced

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.

Breaking Down the Myths: Documentation in AgileA New Perspective: Documentation as an Aid, Not the Star

  continue reading

344 episodes

All episodes

×
 
Loading …

Welcome to Player FM!

Player FM is scanning the web for high-quality podcasts for you to enjoy right now. It's the best podcast app and works on Android, iPhone, and the web. Signup to sync subscriptions across devices.

 

Copyright 2025 | Privacy Policy | Terms of Service | | Copyright
Listen to this show while you explore
Play