updating docs to explain all options