update docs, comments and help