Комментарий должен отвечать на вопрос «зачем» здесь этот код, какая бизнес-необходимость привела к его написанию. Тогда он не устареет вне зависимости от смены реализации. Ещё комментарий может говорить о хаках и трюках, которые (зачем то) понадобились.
Комментарий, который говорит «что» делает код — действительно почти бесполезен при правильной организации оного кода
Очень больно писать на Java веб-интерфейс (по крайней мере до тех пор, пока JVM и OpenJDK не стабилизируются на WebAssembly)
Если нужен Web на Java — есть Vaadin. Сайт на сто миллионов клиентов на нём конечно делать не надо, но внутрикопоративное ПО — очень даже.
PS: demo недоступно, заблокировали наверно вместе с телеграмом
Помимо IDEA и Eclipse есть незаслуженно забытый NetBeans, и что характерно — с порогом входа сильно ниже чем у двух вышеперечисленных, визардами и очень неплохой документацией. Версия 8.2 — вполне достойна, а с визуальной схемой Darcula — так и вообще замечательно работается… Я бы кратко оценил среду как «Delphi для Java» — начинать также просто и интуитивно понятно, а запросы к Google «как в NetBeans сделать *ABC*» зачастую ведут не на SO, а вовсе даже на официальный сайт.
На практике — у нас специалист техподдержки с нулевым знанием Java поставил среду, написал скопипастил и заставил работать нужный код за пару дней.
Комментарий, который говорит «что» делает код — действительно почти бесполезен при правильной организации оного кода
Если нужен Web на Java — есть Vaadin. Сайт на сто миллионов клиентов на нём конечно делать не надо, но внутрикопоративное ПО — очень даже.
PS: demo недоступно, заблокировали наверно вместе с телеграмом
На практике — у нас специалист техподдержки с нулевым знанием Java поставил среду,
написалскопипастил и заставил работать нужный код за пару дней.