In part 1 I discussed a real life story of bad documentation wasting peoples time. In part 2 I provide an update and some notes on the more human side of this all.
After some correspondence on the mailing lists, I submitted a documentation patch. There might an iteration or two of changes to that, but I expect it to make it into the final product (the website) in short order.
All in all its been a mostly positive experience as far as interacting with people. The people on the list were pretty helpful and quite responsive. However, the tools were a bit obtuse. I'm hoping to be able to help fix that fir future releases.