miscellaneous improvements to the default plugin and documentation

Unrelated typo bug which actually stops our repr from working in Python 2!