syntax and comment updates from profxf PR review
syntax and comment updates from profxf PR review

gdhungana/desispec,timahutchinson/desispec,profxj/desispec,desihub/desispec,gdhungana/desispec,profxj/desispec,desihub/desispec,timahutchinson/desispec