- update defaults and document