RMCreative.ru - Блог Голосов: 1 Адрес блога: http://rmcreative.ru/feed/ Добавлен: 2008-06-12 21:34:00 блограйдером ZaiSL

Когда стоит писать комментарии в коде

2015-01-10 18:29:34 (читать в оригинале)

Бытует мнение, что писать комментарии к коду не нужно. Пошло оно, скорее всего, от высказывания одного из отцов программирования — Брайана Кернигана: «Don’t comment bad code, rewrite it». Как всегда, находятся фанатики, которые странно воспринимают авторитетные высказывания и никогда не пишут комментарии принципиально. Это неправильно.

Прежде всего, следует отметить, что документацию к классам и методам надо стараться писать всегда. Она рассказывает, для чего вообще нужен класс или метод и как его использовать.

Что касается непосредственно комментариев в коде, в большинстве случаев они действительно не нужны. Определённо не стоит комментировать каждую строчку метода, описывая словами, какую переменную мы присваиваем на этот раз.

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

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

---

YiiFeed

2014-12-26 20:32:47 (читать в оригинале)

Запустили YiiFeed. Проект выдаёт премодерируемую выжимку новостей о фреймворке Yii на английском. Ленту можно читать через RSS или в браузере, в том числе мобильном. После регистрации каждый может предлагать свои новости.

Вживую посмотреть проект можно по адресу http://yiifeed.com/.

Если он пока не открывается, можно прописать в свой hosts 82.196.4.167 yiifeed.com.

Идея появилась давно. В рунете Yii отлично представлен, а в англоязычном интернете с этим проблема. Всё очень разрозненно и нет единого источника качественной дополнительной информации.

Из закромов эту самую идею помог вытащить Цвигун Вадим, который в конце ноября написал мне в почту и попросился в подмастерья. За месяц мы спланировали всё в Trello, накодили и развернули.

Так как проект некоммерческий и скрывать в нём нечего, код был немного причёсан и выложен в открытый доступ на GitHub. Критика в виде issue и pull request очень приветствуется.

В планах тегирование записей, поиск по тегу (как в этом блоге), RSS по тегу, голосование и комментарии.

---

Закончена первая редакция The Yii Book

2014-12-26 14:16:19 (читать в оригинале)

Профессиональный писатель Larry Ullman сообщил о завершении работ по первой редакции «The Yii Book», книге о Yii 1.1. Он собирается начать работать над второй редакцией, которая будет про Yii 2.0, сразу после праздников. Согласно прикидкам, книга может быть готова уже через 6 месяцев.

Все обновления и редакции «The Yii Book» бесплатны для тех, кто купит книгу до 21 декабря 2016.

---

Yii 1.1.16

2014-12-22 15:09:08 (читать в оригинале)

Вышел релиз 1.1.16 PHP-фреймворка Yii. В него вошло более 120 улучшений и исправлений.

Yii 1.1 официально перешёл в режим поддержки. Обновления 1.1 ещё будут, но не стоит ждать каких-либо новых возможностей или больших изменений в будущем. В данный момент мы активно разрабатываем и поддерживаем Yii 2.0.

Полный анонс читайте на хабре

---

Yii 2.0.1

2014-12-08 11:49:31 (читать в оригинале)

Релизнули 2.0.1. Версия полностью совместима. Вмеру багфиксов и новые возможности.

Полный анонс на хабре