Add documentation on plugin decoration.

[fbourigault]

Since debug_plugins option is removed from PluginClient (php-http/client-common#64), we should document how to decorate plugins as it may be difficult if you are not familiar with promises.