Multiple Improvements

Mostly focussing on documentation and the plugin class file (as that's the one I'm interested in).

I'll comment the PR with more details to explain why I've made such suggestions.