Our docs are shit and we're bad at teaching

The average quality of documentation available for most tech is abysmal. It's often incomplete, poorly-organised (which is to say that it's organised in ways that don't correspond to how it's likely to be used), leaves out vital information or is just plain unreadable. Even much of the documentation that makes sense in hindsight is often more or less incomprehensible in foresight until you see an…