The stuff on our site (see profile) is pretty well documented in the .h files... our next release (hopefully in a week or two) will offer something like MSDN-style overview pages along with detailed function docs.
Really wish there was something like rdoc for C code--and no, Doxygen is fugly and fail.
But yes, I do agree with your first paragrpah. And we're always open to friendly emails--see profile for contact info.