Comment by kirkules

I can remember a number of instances of having to dive into design docs to ascertain how a few systems interacted with each other.

I bet a lot of the time it might be good enough to just have a "here's the set of options we went with" version of a design proposal/doc as documentation