Всё-таки жутко в php неймспейсы смотрятся. Вроде умом понимаю, что ничего ужасного, да и приходится пользоваться, но глаз начинает дёргаться при виде этих обратных слешей.
P.S. Сам только недавно открыл для себя цветовые схемы для netbeans, юзаю тему monokai.
P.P.S. Почему symfony? Имею живой интерес к этому вопросу :)
Это где так пишут? Все нормальные докстринги, которые встречал, в повелительном наклонении.
ггггг
а чтобы не показаться невежливым, пишут так:
public interface Comparator<T> {
/**
* Be great if you compare these two arguments for order.
*/
int compare(T o1, T o2);
/**
* I beg you to indicate whether some object is equal to this Comparator.
*/
boolean equals(Object obj);
}
навскидку загляни хотя бы в jdk или gtk доки прежде чем врать тут на всю страну
Use 3rd person (descriptive) not 2nd person (prescriptive).
The description is in 3rd person declarative rather than 2nd person imperative.
Gets the label. (preferred)
Get the label. (avoid)
К слову сказать, для андроида хомячки-ламеры из гугла рекомендуют:
Every class and nontrivial public method you write must contain a Javadoc comment with at least one sentence describing what the class or method does. This sentence should start with a 3rd person descriptive verb. (отсюда)
Они бы очень расстроились, если бы узнали, что аналитики с ЛОРа на школьном совете постановили так не делать.
3.
Все нормальные докстринги
Все
нормальные
То ли дело питон
Все к этому и шло.
Мир заиграет для тебя новыми красками если закончишь школу и перестанешь врать.