updated docs for options refactoring