In many of the development tools I used today, when I look up a method or function call I am not familiar with in the appropriate help or reference material, two things that I tend to see there are snippets (or whole programs) featuring the method in question. Sometimes, a description, however simplistic and concise, is just not enough. A sample showing how to use and/or how to turn on/off is tremendously helpful as a learning aid.
The second thing I see which is REALLY useful is that there is almost always a "see also" which briefly lists other similar and/or related commands. This way, if I see something that looks like it might be what I want, but then see it related to a bunch of other commands I don't want, I at least know (or think I know) that may not be what I am looking for. On the flip side, if I see something that kinda looks like what I am looking for and have the list of relateds, I can quickly and easily see "Oh yeah THAT is what I REALLY want!".
Just another $0.02. Spend as you wish.