update documentation

far better explanation of config files and some of the internals of the plugin