I apologize for not having read absolutely everything in this thread, but I wanted to throw two ideas out.
What if on the documentation pages there was an optional feedback popup (they would need to click it to see it) that could ask basic questions like "Why did you come to this page", "How good was the experience", "If there were issues, what were they?". This way we could hopefully collect some extra (anonymous?) data from people that are less willing to participate in forums and the like. My second thought was allowing links to external sources in the description of each proc. That way when a user looks up a definition, they could follow a link to a page or blog that uses the function in a more contextual manner. Of course doing this would allow the page author to go into detail on how to tie multiple procs together and avoid pitfalls and explain nuances.
