adding more detail to documentation for options