💬 Komentarze

Komentarze służą do dokumentowania kodu i są ignorowane przez interpreter.

Komentarz jednoliniowy

// To jest komentarz jednoliniowy
let x = 10;  // Komentarz na końcu linii
        

Komentarz wieloliniowy

/* To jest komentarz
   wieloliniowy który może
   rozciągać się na wiele linii */

let x = /* komentarz inline */ 10;
        

Komentarz dokumentacyjny

/**
 * Oblicza silnię liczby.
 *
 * @param n - liczba do obliczenia silni
 * @return silnia liczby n
 */
fn factorial(n) {
    if (n <= 1) return 1;
    return n * factorial(n - 1);
}
        

Dobre praktyki

💡 Wskazówki

Pisz komentarze wyjaśniające "dlaczego", nie "co"
Aktualizuj komentarze przy zmianach kodu
Używaj komentarzy dokumentacyjnych dla funkcji publicznych
Unikaj komentowania oczywistego kodu

// ❌ Źle - oczywiste
i++;  // zwiększ i o 1

// ✅ Dobrze - wyjaśnia "dlaczego"
i++;  // pomiń nagłówek tabeli
        