Better plugin behaviour

And a start on some fuller documentation.

Are you happy to hook these docs into RTFD?