updated documentation and defaults