update defaults + doc