replying less on catching exceptions
updating the plugin docs a little