Not sure if this belongs in RFC 36 or the manual pages, but @bryujin asked us to document how to fully comment out a submission directive (i.e. not just part of one.) Example:
#!/bin/sh
# flux: --job-name=hello
# flux: -N 2
# flux: # --amd-gpumode=CPX # comment this out to specify the gpumode
# flux: --env=-* # this is a comment _within_ a directive
#
...