Комментарии и формат

Комментарии — это текст для людей, который Java полностью игнорирует. Два вида:

// однострочный — до конца строки

/*
  многострочный —
  можно растянуть на сколько угодно строк
*/

Хороший комментарий объясняет зачем, а не что — само “что” и так видно из кода:

// ❌ плохо: просто пересказывает код
int x = 5; // x равно 5

// ✅ хорошо: объясняет неочевидную причину
int retries = 5; // больше — таймауты API становятся заметны пользователю

Формат кода. Java не требует отступов для работы (в отличие от Python), но это стандарт читаемости: тело { } — на 4 пробела правее. Имена переменных и методов — camelCase (userName, calculateTotal), классы — PascalCase (UserService).

/**
 * Считает сумму двух чисел.
 *
 * @param a первое слагаемое
 * @param b второе слагаемое
 * @return сумма a и b
 */
int sum(int a, int b) {
    return a + b;
}