add notes for new options

Deepak Rangarajanrequested to merge
rangarad/docs:add_some_docs into main

Merge request reports