to say that a BB is not user friendly and that its 'tricks' are not well-documented, its like saying that a computer is not documented on how to use its functionality...
the basics are documented. the 'how to' to get it up and running is documented. server-side ins and outs are, for the most part, documented. there are a lot of situational documentation that can be found here, but i think the basics are pretty much available from the documentation you receive with the handset.