Multiline Comments Style guideline // or /** */

[zelf0]

Topic

Working on https://github.com/processing/p5.js-website/issues/1385, there is discussion about the current style guideline for multiline comments, which is to "Use /** ... */ for multiline comments."

There isn't a reason provided as to why that format is better than others, and currently the example code seems to be using // for multiline comments. Should we revise the style guide to recommend using //, since its what contributors seem to be defaulting to, and it's more common since it's the default way text editors comment out code automatically. It also might be more accessible for beginners to only have to use one commenting format for comments, whether they are single or multiline.

[nickmcintyre]

@zelf0 thanks for the suggestion—all sounds good to me.

[Qianqianye]

Thanks @zelf0 for the suggestion. @nickmcintyre, please feel free to open a PR to update the documentation_style_guide.md. Thanks!

[nickmcintyre]

@zelf0 how about you handle this PR since you made the suggestion?