improved docs for next option