Writing documentation is
hard. You're welcome to improve upon that, the wiki is here for just that. Barring that, I'm always open to constructive criticism, the initial post has been revised many, many, many times to address concerns raised on the forum.
If you want heavily biased and targeted writing, look at the (K5) Fonts hack post.
That one is a doozy, by design
.
In the mean time, unless you have specific, targeted questions, I'm afraid we can't do much better than what's already there. Because much of what we tend to do is, unfortunately, repeating the exact same thing over and over again. Which is why there's a FAQ, and a FGA, because it gets a little bit tiring after a while
.
And, yeah, surprisingly enough, better documentation helped, tremendously. Funny, that.
I'm not saying everything is perfect, but without better feedback than something that, to say things bluntly, feels like it amounts to "wah, wah, I don't understand", well, we can't do miracles.