kaycebasques / kayce.basqu.es

my personal website
https://kayce.basqu.es
21 stars 4 forks source link

The danger of metaphors/analogies in technical documentation #91

Open kaycebasques opened 3 years ago

kaycebasques commented 3 years ago

I actually fully support their use. But this was a good point I've never thought about before.

People draw other conclusions that the author did not intend.

The correct path forward, IMO, is to anticipate those other conclusions. Or to explicitly acknowledge this problem.