This is the closest thing we have for of a convention for shell code comments. It would be cool if the parser could understand the syntax: https://google.github.io/styleguide/shellguide.html#s4-comments