The state of the Audio Documentation in general is lagging when compared to other technologies on our platforms and documentation bug reports help us not only fix missing or incorrect information but let us gauge demand for new documents.
File bugs to ask for what you want to see documented. Use the “Feedback” link at the bottom of Reference Library pages when you spot a problem or use the bugreporter site. Note what frameworks/topics you would like to see covered in a "Programming Guide" for example as opposed to simply having "Reference” documentation and so on. It all helps.
While headers do contain a surprising amount of information not found in the docs (and it's surprising how many developers don't even reference the headers!) they are not a substitute for technical documentation.