Dlaczego tak
Komentarz dokumentacyjny JSDoc zaczyna się od /** (dwie gwiazdki) i kończy */, a znacznik @param podaje typ w nawiasach klamrowych, nazwę i opis parametru. Komentarz jednowierszowy // jest w JavaScript poprawny, ale generatory dokumentacji i podpowiedzi edytora go pomijają. Zapis <!-- --> to komentarz HTML, a # rozpoczyna komentarz m.in. w Pythonie — w JavaScript wywoła błąd składni.