Tidy up the docs a bit

Only a couple of other points:

1. What does polyvalent mean?
2. I think perhaps the Class Stubbing section could be a bit clearer? I don't understand the whole $classname thing