353 karma · joined December 30, 2019
Undefined/vague abstractions or methaphors: Leave the meaning of notoriously overloaded terms like component, plugin, container etc. unexplained in your specific context of writing.
Homonyms: One term has several meanings. E.g., "server" is either a machine or a OS process.
Synonyms: One meaning has several terms. E.g., "module" and "project" in Maven.
No examples: Only rely on the reader ability to interpret pure abstractions instead of giving him/her examples to abstract from. E.g., provide only the EBNF of a certain language.
[1] https://techcrunch.com/2022/06/08/figmas-dylan-field-will-di...
[1] https://en.m.wikipedia.org/wiki/Illusion_of_transparency
It makes steel brittle.
do not do <statements> unless not <expression>
of some fun programming language whose name I forgot.