update docs, better placement of output message, etc