:: Не фоксом единым
Re: Классификация кода
of63

Сообщений: 25161
Откуда: Н.Новгород
Дата регистрации: 13.02.2008
() никогда не удастся назвать переменную так, чтобы она была понятна хотя бы ближайшим потомкам без расшифровки в комментарии. Берешь ближайшую инструкцию по заполнению к-л отчета для ЦБ, или ГНИ, и начинается: в трактовке от Иван Иваныча это заполняется так, а в таком то году переделали по приказу Петра Петровича, но не везде, а только для клиентов с 43-м размером ноги, и т.п...
Ratings: 0 negative/0 positive
Re: Классификация кода
Igor Korolyov

Сообщений: 34580
Дата регистрации: 28.05.2002
По-твоему комментарий типа "в трактовке от Иван Иваныча это заполняется так" сильно поможет понять логику
Для г*вёной постановки задачи код по определению не может быть не г*вёным. И никакие комментарии это не исправят.
С вероятностью в 99% тот кому сие чудо достанется в наследство попросту всё это выкинет, не особо вникая в то, кем был Иван Иваныч и почему он круче Петра Петровича


------------------
WBR, Igor
Ratings: 0 negative/0 positive
Re: Классификация кода
of63

Сообщений: 25161
Откуда: Н.Новгород
Дата регистрации: 13.02.2008
А у нас отчеты > лет 5 и не живут, даже меньше. У проверяльщиков в мск жизнь кипит, играет, в одном месте. Постановка задачи спускается (извините, но это буквально) с инструкциеией по заполнению, как это видится проверяльщикам, на их языке. Этот текст и переносится в прогу в качестве комментария. + трактовка текста от местных оналитеков. Это и есть ТЗ. Тебе наши инструкции от ЦБ, по заполнению отчетов, кажутся г..ными, или, думаешь, надо заменить наших наших манагеров?
Ratings: 0 negative/0 positive
Re: Классификация кода
S-type
Автор

Сообщений: 2969
Дата регистрации: 24.04.2004
Igor Korolyov
Есть такой шаблон/приём/подход - минимизация "точек выхода" из метода. [...] то у такого шаблона есть свои плюсы...

Наверное, такой же вредный, как SOLID.

Igor Korolyov
Есть такое мнение, что если код нуждается в комментариях, то он плохой.
Конечно, Линус он гений. А мы люди простые. К тому же, мы не "носители" английского языка. Опять таки, комментарий может быть не по поводу работы программы, а по поводу предметной области / багтрекера / личного отношения к задаче / признание в любви ...
Ratings: 0 negative/0 positive
Re: Классификация кода
Божья_коровка

Сообщений: 25720
Дата регистрации: 23.08.2001
S-type
Опять таки, комментарий может быть не по поводу работы программы, а по поводу предметной области / багтрекера / личного отношения к задаче / признание в любви ...
Комментарий встречала - "Еще раз какая нибудь су%%% тронет этот кусок, сам прибью. Нач. отдела."


------------------
Жись, она как зёбра, полоса белая, полоса черная, а мне всегда задница достается...
Ratings: 0 negative/0 positive
Re: Классификация кода
Simple777

Сообщений: 33855
Дата регистрации: 05.11.2006
Божья_коровка
S-type
Опять таки, комментарий может быть не по поводу работы программы, а по поводу предметной области / багтрекера / личного отношения к задаче / признание в любви ...
Комментарий встречала - "Еще раз какая нибудь су%%% тронет этот кусок, сам прибью. Нач. отдела."

:xixi:
Ratings: 0 negative/0 positive
Re: Классификация кода
S-type
Автор

Сообщений: 2969
Дата регистрации: 24.04.2004
Божья_коровка
Комментарий встречала - "Еще раз какая нибудь су%%% тронет этот кусок, сам прибью. Нач. отдела.
Именно!

И, ни каким правильным кодом такую мета-информацию в программе не оформишь.



Исправлено 1 раз(а). Последнее : S-type, 30.10.17 17:06
Ratings: 0 negative/0 positive
Re: Классификация кода
Simple777

Сообщений: 33855
Дата регистрации: 05.11.2006
-



Исправлено 1 раз(а). Последнее : Simple777, 31.10.17 12:39
Ratings: 0 negative/0 positive
Re: Классификация кода
S-type
Автор

Сообщений: 2969
Дата регистрации: 24.04.2004
Поправил косяк... Каюсь.
Ratings: 0 negative/0 positive
Re: Классификация кода
Vedmak

Сообщений: 5949
Откуда: CiTY
Дата регистрации: 30.10.2003
Igor Korolyov
Vedmak
Первый пример "для людей", а второй "для себя".
Ну, если подразумевать под "людьми" малограмотных "индусов/китайцев" то да, соглашусь. Только им и так понятнее не станет, и этак не хуже будет В общем я бы не стал...

А кто контролирует контролера ?

Отчего возникла уверенность, что ты не "индус" ?

Самоуверенность и самомнение греховны! Да прибудут с тобой Ctrl, Alt и Del.


------------------
Говорить стоит лишь для тех, кто слушает.
Ratings: 0 negative/0 positive
Re: Классификация кода
_vit

Сообщений: 5173
Дата регистрации: 29.07.2002
Божья_коровка
S-type
Опять таки, комментарий может быть не по поводу работы программы, а по поводу предметной области / багтрекера / личного отношения к задаче / признание в любви ...
Комментарий встречала - "Еще раз какая нибудь су%%% тронет этот кусок, сам прибью. Нач. отдела."

Фрагмент кода я понимаю а кусок...
Это тот самый код про который часто упоминает ИК?
Ratings: 0 negative/0 positive
Re: Классификация кода
S-type
Автор

Сообщений: 2969
Дата регистрации: 24.04.2004
_vit
Фрагмент кода я понимаю а кусок...
Это тот самый код про который часто упоминает ИК?
Наверное именно потому, что этот фрагмент сильно напоминает кусок определённого вещества (схож цветом, запахом и свойством плавать) те, кто с ним сталкивается, и пытаются его переписать...
Ratings: 0 negative/1 positive


Извините, только зарегистрированные пользователи могут оставлять сообщения в этом форуме.

On-line: 6 MikhsR  (Гостей: 5)

© 2000-2024 Fox Club 
Яндекс.Метрика