Some sins of technical writing:
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.