18.1Comments / Multiline

複数行コメント

複数行のコメントには `/ ... */`** を使用します。

これは JSDoc 形式としても知られており、多くのツールがこの形式のコメントを解析してドキュメントを自動生成できます。`//` を複数行並べるよりも、ブロックとしてまとまっている方が視覚的にもコメントであることが分かりやすいです。

❌ Bad
// bad
// make() returns a new element
// based on the passed in tag name
✅ Good
// good
/**
 * make() returns a new element
 * based on the passed-in tag name
 */