I recently came across as email from a goggle group that I'm part of that is centered around Hyde which is what I'm currently using to statically generate my website/blog. The email was basically asking "What's up with the docs?" and all I can do is just shake my head in agreement.
The problem is that a significant amount of these open source projects are created by people whose talent is mostly with the creation of the tools and not with the associatated docs. This leaves a lot of people in the dust because people see the end result and want to have something cool like that, but don't have the time/desire to dive into the code and learn how it works.
It's not because they are lazy, it because we are all busy people and sometimes we don't need to know every aspect of something to use it. For example, you don't have to be a mechanic to drive your car1.
Honestly, I wish I could help this guy out because I've had similar problems with this and other projects and it can be daunting to stick your head out and ask the questions. But you have to have the courage to suck in order to get any better at something.
-
... but a little more knowledged in this area can save you a ton of money. ↩