Комментарии

Комментарии предназначены для людей, а не для компьютеров. Они служат пояснениями, напоминаниями, подсказками или предупреждениями. Также можно временно отключать код при отладке.

Однострочные комментарии

// Это однострочный комментарий
function learnJavaScript() {
  // Это однострочный комментарий
  var hello = 'Hello world!!!'
  return hello
}

Многострочные комментарии

function learnJavaScript() {
  /* Этот комментарий занимает несколько строк.
     Обрати внимание — его не нужно прерывать до конца */
  var hello = 'Hello world!!!'
  return hello
}

Комментарии внутри кода

var hello = 'Hello ' + x /* вставить значение x */ + '!'

Самодокументируемый код

Хороший код должен быть самодокументируемым — читабельным без большого количества комментариев. Используй описательные имена переменных и функций.