Remove README file in favor of markdown version
Update failure callbacks section
Merge pull request #181 from jheiss/failure_callback_doc

Update documentation regarding failure callbacks