At my previous work i was, among lots of other things, responsible for upgrading a storage system.

I though i should share and illustrate this experience.

The state of the old solution.

How the previous supplier documented it.

How we got approval from management.

How the new storage system was funded.

How the management understood it.

How the numerous architects understood it.

How the developers and users used it.

How it was actually designed and implemented.