I’m torn about that.
99% of the users won’t ever see the file since ./discourse-setup hides all the complexity.
The users going to the file, and reading a commented line, researching the alternative values of the key, and opting into a different one, while managing to ignore the various warnings in Meta are difficult ones.
We could just hide the key from that commented line, making it harder to shoot yourself in the foot.