update documentation to have full examples of the API. add PystMessageConfirmation wrapper; fix default message merging