Hi @Skinnytorus,
I think what we would like to have is a full reference documentation of every element (generators, modifiers, renderers, lights, etc...) with one page per element type. This reference documentation would be organized in the same way as it is in the software.
Also, this raises the question for us of creating a house-made tool for documenting elements. That would enable to nicely integrate the reference documentation into our code-base and hence facilitate maintenance. That could even one day enable to have documentation directly integrated in the software.
We did not plan this yet. Before proceeding, I'd be curious to have more feedback from other users of the documentation. (Community is still small, so for us it's rather hard to know how the current documentation is used).