3 ms·
I mean, you're right... but the goal of an analogy isn't to be perfect, but to be a rough mental model to quickly express a concept. I think it's fine. Differe
by cameronbrown 6y ago
I mean, you're right... but the goal of an analogy isn't to be perfect, but to be a rough mental model to quickly express a concept. I think it's fine.
Different jobs require different levels of abstraction and design docs fulfil that role for software engineers.
- learc83 6y agoYes models can be helpful even if they aren’t perfect. But not only is this one too far off to be useful, it does more harm than good. The expectations that happen when people (specifically managers) start thinking of design docs as blueprints, software architects as architects, and developers as builders are downright dangerous.
- sgt-serverless 6y agoDangerous seems a bit extreme. If developers aren't builders, then what are they?
- DEADBEEFC0FFEE 6y agoModels are always imperfect.
- shuntress 6y agoThat is true but if the analogy is too imperfect then it won't express the right concept. A bad analogy is like a leaky screwdriver.
- gowld 6y agoAn analogy is a blueprint for an explanation.