Об учебнике

От читателя требуются основные знания о программировании и общие компьютерные навыки. Числа-номера строк в примерах не являются частью кода.

Документация

Для компиляции и запуска программ вам понадобится JDK (Java Development Kit), который можно скачать по ссылке http://www.oracle.com/technetwork/java/javase/downloads/index.html

Полный справочник Java™ Platform, Standard Edition 6 API Specification опубликован на сайте http://docs.oracle.com/javase/6/docs/api/index.html компании Oracle.

Полный справочник Java™ Platform, Standard Edition 7, API Specification (с апреля 2015 года не обновляется официально) http://docs.oracle.com/javase/7/docs/api/index.html компании Oracle.

Полный справочник Java™ Platform, Standard Edition 8, API Specification опубликован на сайте http://docs.oracle.com/javase/8/docs/api/index.html компании Oracle.

См. также

В Википедии имеется статья по теме «Java»

Комментарии

В Java существуют комментарии, они помогают пользователю понимать свой код, или чужой, если конечно их добавить.

class CommentTest {
    public static void main(String[] args) {
        System.out.println("Здравствуйте, я ваша тётя!"); // Здесь пишем комментарий
        /*
         Компилятор полностью игнорирует комментарии
         И что бы я тут не писал вывода на экран не будет
        */
    }
}

Вывод на экран :

Здравствуйте, я ваша тётя!

Комментарии могут быть разных видов, например:

// - текст вашего комментария начнётся сразу за чертами и кончится в конце строки.

/*
В этом комментарии может быть сколько угодно строк,
важно только ставить в конце */,
а в начале /*
*/

Документирование комментариями:

/**

• тест
• комментария
• и т.д.
• /

Ну если конечно писать в комментариях что-то важное то они действительно помогут (например начинающим):

class SecondCommentTest {
    public static void main(String[] args) {
        System.out.println("Program started."); //Здесь мы выводим на экран надпись Program started.
    }
}