This is a wonderful comment! There is missing descriptions of things, the quality, the metrics to use when describing such things and we, the users of those said tools end up spending a lot of time going through bad documentation and learning things by practice. For a trade that pushes the digital frontier to everything it touches, the learning is surprisingly analog.
Read the book About Face : Essentials of Interaction Design, it’s a great resource on design and make projects around interaction as the title suggests.