4 ms·
> Post-hoc design documents written specifically to explain work to a promo-committee after the feature has been built I actually wish these would get written
by nharada 4y ago
> Post-hoc design documents written specifically to explain work to a promo-committee after the feature has been built
I actually wish these would get written all the time. Not because of a promo-committee, but because post-hoc documentation explaining how the system works after it's already been built (as opposed to a design doc from the planning stages that may or may not reflect the actual state of the built system) is really valuable.
- erik_seaberg 4y agoMy dad used to go aboard a ship, take measurements, and draw what they call an as-built blueprint for this reason. He’d find crazy stuff like “they must have moved this wall a little because the equipment wouldn’t have fit in the space on the plan.”