documentation updates
catch errors, persistence