I completely agree that Documentation + Q&A together = Awesomeness. My first programming language was PHP, which I self taught to myself using only the online documentation. Without the comments at the bottom of every page of documentation, the learning process would have taken a lot longer. I haven't looked at the PHP documentation in years, but I hope that the discussions still exist. I'm surprised that more documentation doesn't have the same kind of commenting system, or every a better one... from what I can remember the discussions on the PHP documentation were single threaded and didn't have any user moderation. I also recall people commenting and saying "Don't listen to Bob's comment above! It's completely wrong!! Here's how you do it: ..." followed by: "Steve has it almost correct, but you should really use X instead of Y.", followed by 10 more comments with no real conclusion on how to "correctly" query a mysql database. If there was a Stack Exchange type of Q&A that was embedded on each individual page of documentation, that might be very useful.