Наверное никто не любит в его исходниках копаться...

Код надо писать так чтобы всякие комментарии были излишни. Фаулера лучше почитай "Рефакторинг". Одним признаком кода с душком являются всякого рода комментарии в том числе и жава доки. Мне вот они никогда не были нужны. А всяким слабокам лишь бы нюни разводить.

java .net... Кто все эти люди :-? Ну кривой и косой этот их ибатис. И афтору на доки поибатис. Ну что с того? В сети и без них катастрофическое количество мусора.

> Одним признаком кода с душком являются всякого рода комментарии в том числе и жава доки

Ты это на полном серьёзе? А как же doxygen доки, скажем, для API Reference каких-нибудь движков?

>Прозреваю что история с автором ion3 имеет теже корни.

Где можно почитать про это?

Из личной практики: никому нафиг не сдалось держать в голове сотни переменных и смысловую нагрузку десятков твоих функций.
Программист, пишущий код без комментариев, не заботится о том, что кто-то кроме него будет поддерживать его творчество.
Поэтому в биореактор таких программистов, как бы они ни прикрывали свою лень к комментированию кода.

Зато они стараются обеспечить себя работой на долгие годы.
Главное чтобы не сильно палились, а то проект сразу уйдёт в более надёжные руки.
Потом из-за них тонны говна без комментов разгребать, сильно бесит

>Ты это на полном серьёзе?

Вообще да. Но я больше имел в виду - комментарии в прикладном коде. Всякие либы и фреймворки конечно должны снабжаться хотя бы пустым сгенерированным жавадоком, где можно просто посмотреть что есть. Но детальные комменты это изврат. Тем более за них не приплачивают.

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

Тем более за них не приплачивают.

Нищеброд, с этого инадо начинать, всяк высокопарный высер кончается тем что у высерающего нисчастная жисть и нет денех, охохо.

честно говоря надоело искать каждый раз эту ссылку, легко гуглится по ion forn antialiasing или както так

в общем следите (если за вами никто не следит) за своим психическим здоровьем

а как же ZOG ?

описанные в топике программисты тоже надеялись на ZOG

Если вы пишете текст, то пишите по-русски

Сабж.

>Does Ion support anti-aliased fonts/Xft?

>No. Antialiasing is an ugly self-defeating kludge, as is subpixel placement.

Все правильно. Антиалиасинг не нужен. Автор ion3 прав.

Читал пару сырцов где комментов было больше кода, страшное зрелище а главное всеравно нихуя непонятно

программист неспособный понять как работает чужая программа без комментариев не нужен!

Таракан изыди, у тебя в межушном узле не вмещается логика, посему твой маразум не всилах понять малую весчь - нефиг плодить проблемы.

код должен быть самодокументируемым

автор иона может и псих, но вм хороший :)

Я стараюсь всегда предельно четко документировать код комментариями и уважаю такой код. Лентяев, которые оправдывают свою лень и нежелание мыслить четко и четко пояснять свою мысль, не уважаю. Можете звать меня психом.

код должен быть самодокументируемым

и еще самонаписуемым(?!)

Мое мнение о коментариях такое: он должен описывать бизнес логику.

То есть обязательно описание всех внешних интерфейсов.

Так же обязательно описание неочевидных алгоритмов, нестандратных для проекта паттернов и методик.

Но когда требуется написать что нибудь типа: int c = 0; // в этом переменую мы будем помещать кол-ов ---- это большое зло

Белка, не тормози. Правил без исключений не бывает. Чудак пишет, что все и без док просто:

The thing about iBATIS is that the actual Java code is very simple to understand — you only use about 5 classes and they're very simple.

http://lorquotes.ru/view-quote.php?id=4876

> Код надо писать так чтобы всякие комментарии были излишни. Фаулера лучше почитай "Рефакторинг". Одним признаком кода с душком являются всякого рода комментарии в том числе и жава доки. Мне вот они никогда не были нужны. А всяким слабокам лишь бы нюни разводить.

Таки чуствую себя слабаком.

http://62.149.5.84.nyud.net/i4/8d/7d/c61681155fece4a13d897f13da24.png

это как раз плохой пример, писать так нельзя

Мое мнение о коментариях такое: он должен описывать бизнес логику.

Еще он должен быть подогнан под какой-нить doxygen и прочие.

и комментарии не на кириллице

мужык, я эту хрень вдоль и поперек ковыряю, и там не все так просто, не зря он написал 69 страничный мануал.

вопщето на том убогом недоязычке по другому нельзя, эти мегапартянки нечитабельны

Кстати, про комменты: http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-...

да, этот код плохого качества, и не читаем.

Купи себе книгу - Clean Code

> да, этот код плохого качества, и не читаем.

Я знаю, это был ответ на вопрос о комментариях в коде.

> это как раз плохой пример, писать так нельзя

Кстати, а чем плоха машина состояний? Чем ее обычно заменяют?

Перепиши код так, чтобы комментарии были не нужны. Давай осмысленные и читаемые имена переменным и функциям

теоретег

> Перепиши код так, чтобы комментарии были не нужны. Давай осмысленные и читаемые имена переменным и функциям

Это не отменяет комментариев.

Elsi pravilno napisano - Eshyo kak otmenyaet!