update defaults and readme docs