Можно ли сделать самодокументацию в JavaScript

Да, можно. Самодокументация достигается за счёт чистого, выразительного кода, комментариев и JSDoc.

JSDoc — стандарт для документирования кода:

/**
 * Складывает два числа.
 * @param {number} a Первое число.
 * @param {number} b Второе число.
 * @returns {number} Сумма a и b.
 */
function add(a, b) {
  return a + b;
}

Чистый код (имена функций/переменных должны говорить за себя):

function calculateTotalPrice(items) { ... } // понятно без комментариев  

Комментарии — объясняют сложную логику, но не дублируют код.

Современные IDE (VS Code, WebStorm) используют JSDoc для автодополнения и подсказок.