While I agree - the point is that what you describe is exactly the same as we have now for the binding documentation, and we are still in the position that unfortunately very very few people take the time to do this. I think in most cases it’s not really a matter of how hard it is - most people simply don’t bother. Once they get their system working, they are happy 
