updating docs, defaults