Komentarz jednoliniowy w JavaScript rozpoczyna się od znaków // i trwa do końca wiersza. Jego celem jest udokumentowanie intencji autora kodu: co dana instrukcja robi, dlaczego jest potrzebna lub jakie ma założenia. Dobry komentarz powinien być konkretny i zgodny z działaniem kodu, a jednocześnie nie powinien wprowadzać w błąd.
Poprawna treść komentarza: "w zmiennej x maksymalna wartość ze zmiennych a, b, c" opisuje typową operację spotykaną w skryptach: wybór największej wartości z kilku zmiennych i zapisanie jej do innej zmiennej. Taki opis jest merytoryczny (mówi co ma się stać) i pasuje do dokumentowania pojedynczej linii, np. przypisania wyniku do x.
Pozostałe propozycje są niepoprawne, bo opisują inne działania niż wybór maksimum albo nie stanowią sensownej dokumentacji:
- "wybór losowej wartości ze zmiennych a, b i c" dotyczy losowania, a to inna operacja (wymagałaby np. generatora losowego i logiki wyboru).
- "w zmiennej x minimalna wartość ze zmiennych a, b, c" opisuje wybór minimum, czyli działanie przeciwne do maksimum.
- "nieprawidłowe dane." jest zbyt ogólne i nie opisuje mechanizmu działania instrukcji; taki komentarz nie pomaga zrozumieć kodu.
Wskazówka egzaminacyjna: wybieraj komentarz, który najściślej opisuje rezultat wykonywanej instrukcji (co trafia do jakiej zmiennej i na jakiej zasadzie), a nie luźne stwierdzenie lub opis innego algorytmu.
