documentation update
clean up doc strings and various parameters for consistency