Индийское.

[mibori]

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

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

Comments

[mibori]

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

[blackyblack]

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

[blackyblack]

Про программирование с использованием псевдокода слышали? Вот как раз комментарии являются описанием того, что хочет получить программист в коде.
Что там Керниган по этому поводу пишет? Пруфлинк плиз.

[blackyblack]

Всё-таки хотелось бы увидеть пруфлинк. Своего мнения я не поменяю, но в Кернигане немножко разочаруюсь. :) На моей стороне МакКоннел.

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

[blackyblack]

Это всё что вы можете сказать? Звучит как хамство.

[blackyblack]

И не стыдно хамить незнакомому человеку?

[blackyblack]

Это всё дурное воспитание. Молодёжь нынче ужасно невоспитанная.

[blackyblack]

Думаете в Финляндии она лучше?

[lomeo]

Есть мнение, что комментарии должны сообщать не что функция делает (т.к. это должно быть зашито в её сигнатуре) или как функция работает (об этом должен сообщать понятный код функции), а семантику, которую невозможно или неудобно выразить в языке. Например, ассоциативность метода equals; очередь, в которой должны вызываться функции. В общем, инварианты, пре- и пост- условия и т.п.