Added a flag to configure behavior for hooks status return.
Greatly improved documentation README.rst.