Binding yourself to high level design by details - irrevocably
Little over half a year ago I was present in an unprecedented blunder by a team leader. I saw how the fervor to succeed made for a design mishap and how the same fervor made for a Mr. Know It All team leader. TL;DR detailed designs are for devs, not VPs or CTOs How to not design like a galley master and not be shackled like a rowing slave When one is asked to make the design document of a new development, one must be very very careful how flows are put on paper. These documents are binding and every word or terminology in them can and will haunt one for a long time. In order to try to minimize a possible mess here are some rules of thumb, gathered from my own experience Detailed documents glide up like migrating birds High level design documents may and will end up to the higher ranks of the corporate hierarchy. Be vague when describing functional parts. Do not put highly detailed implementation details in a high level design, otherwise once the details are stated and ...