Here is an example: I would like to repaint() at 30Hz.
First I search the forum -- lots of questions that fail to provide code examples, but I learn the way is to use a timer.
I google JUCE timer, get to http://www.juce.com/doc/classTimer -- wall of text.
So looking through I pick startTimerHz and Google that: only five hits -- two are Japanese, one is the above doclink.
One is https://github.com/julianstorer/JUCE/blob/master/examples/SimpleFFTExample/Source/SpectrogramComponent.h
And I can extract the information I need in about 10 seconds.
Because on that page it is presented in context. If I see something in action I can assimilate it instantly. But if I have to read a description of it, it just doesn't go in. However, once I have the example, I can then read the blurb and everything makes sense.
So it might be nice to start the documentation page for this Timer class with a basic example.
Or maybe a link to that code file. That would save duplicating anything.
Example driven/centred documentation is very powerful.
PS I like the dark background for the help pages mmm
PPS Just noticed http://www.juce.com/doc/classPath does exactly what I'm suggesting. So maybe this is a redundant post...