re-fixing #84, forUpdate / forShare
docs prep for release
release 0.5.8