Комментирование методов
261
19 августа 2017, 00:31
Допустим, есть класс, реализующий некий интерфейс. Где лучше писать комментарии к методам: в классе или в интерфейсе, или же и там, и там? Есть ли какие-либо рекомендации по этому поводу?
Answer 1
В интерфейсе всегда описываем, что реализуют наследники. Если у наследника нет отличий в деталях реализации от интерфейса, то ставим:
/**
* {@inheritDoc}
*/
иначе более детально поясняем в комментарии.
-
12:26
-
10:30
-
18:43
Продвижение своими сайтами как стратегия роста и независимости
-
22:46
-
06:18
-
12:23
-
20:41
-
06:31
-
21:28
ТОП-10
- Почему SERVER_ADDR имеет не тот IP 50069 visits
- Как заменить $_SERVER[REMOTE_ADDR] на IP клиента в PHP за двумя Nginx? 31918 visits
- Хочу вывести несколько строк из массива в один div, выводит только много undefined; подскажите, что делать? 26029 visits
- Как через css изменить цвет png изображения? 11736 visits
- Blob video url download 11284 visits
- Php curl запрос через прокси с авторизацией 10687 visits
- Работа с captcha vk api 9486 visits
© "hostciti.net" 30.1.2026 | 16:22