Индийское.

[mibori]

Некий samond хочет автодокументировать свой ObjC. Это странное желание.

Возможности именования методов в ObjC таковы, что не требует комментариев:
- (void)fadeInWithDuration:(NSTimeInterval)duration andWait:(NSTimeInterval)wait

Comments

[mibori]

пробел хайлайтил?

[beroal]

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

[beroal]

Ну я понял. Я преувеличил, вы преувеличили, вместе посмеялись. :)

Если же серьёзно, то мысль моя проста. Тот, кто после 5 минут умственного напряжения выдыхается, из-за этого объявляет предмет рассуждения мусором, расписывается в собственной неполноценности. mibori предлагает это делать. И ваша мысль идёт по проторенной дорожке: «неграмотно спроектированного кода». Откуда взялись эти слова? Я не говорил такого. Вы сами автоматически додумали, по принципу: «То, что я не понял, - неграмотно». :D Не любое знание можно усвоить за 5 минут, даже научиться играть на гитаре нельзя за 5 минут. Вместо
«я думал, не смог понять, пришёл к выводу, что это мусор»
я предлагаю
«я проанализировал, всё понял, пришёл к выводу, что это мусор».
Насколько по-разному эти фразы говорят о думающем. Почувствуйте разницу! ;)

[mibori]

в целом да.
только если требуется откомментировать "почему", то уже нужно задуматься, а правильна ли архитектура.

[blackyblack]

Странное мнение. Если требуется комментировать, почему функция так себя ведет, то ставится тег ///HACK. Обычно комментируется именно то, что функция делает, но вкратце, чтобы не смотреть в тело функции.

я Дейл Карнеги

[pingback_bot]

User beroal referenced to your post from я Дейл Карнеги saying: [...] Так надо ставить комментарии, или не надо? [...]