Added information on the new 'success' callback

Updated the document ion to describe the use case for the new 'success'
callback function.