Partials documentation improvements

Hi there,

I and some friends had some trouble figuring out how the partials parameter passing happened. Now that I have it (hope so!) figured out, I tried to make the documentation clearer  :)

Feel free to take as many or few commits as you wish, I tried to separate them into several levels of doc refactoring.

Greetings,
Matti