Здравствуйте, elmal, Вы писали:
DO>>И для тех и для других.
E>Странно. Сколько работаю, у меня как то больше упор на программирование всегда был. В худшем случае на фикс багов. Документацию обычно читаю на всякие Фреймворки, а она не по ГОСТам написана, да и вообще не на русском языке 
. И написана совсем не так, как в институтах учили, почему то ее читать отвращения не вызывает, не смотря на ее англоязычность .
Мне не нравится самогенерирующаяся документация для разных java-проектов. Часто скачаешь, там толком не написано, что делает библиотека, какие там основные классы. Хорошо, если будет маленький примерчик использования.
Зато полно комментариев в стиле:
/**
* Get name by id.
* @param id identifier
*/
public String getName(int id);
