The Dangers of Documentation

When, how, and why to avoid setting things in stone.

Ashley Wali
Jun 15, 2018 · 6 min read

Boxes and lines

You make decisions too early

The cost of change feels higher than it is

Product managers rely on guesses rather than data

So when is documentation appropriate?

Agile Insider

Exclusive & practical insights about rapidly delivering value.

Sign up for All Things Agile

By Agile Insider

The best of Agile Insider delivered to your inbox Take a look.

By signing up, you will create a Medium account if you don’t already have one. Review our Privacy Policy for more information about our privacy practices.

Check your inbox
Medium sent you an email at to complete your subscription.

Agile Insider

Exclusive and practical insights that enable the agile community to succeed.

Ashley Wali

Written by

Product leader @discuss.io. Inspired by @adilwali, our 2 boys, & the beauty of the PNW. Passionate about gender equality, travel, & weekends at home.

Agile Insider

Exclusive and practical insights that enable the agile community to succeed.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store