miscellaneous improvements to the default plugin and documentation