Важность нейминга

Программисты не просто так становятся буквоедами. Ведь неправильный нейминг потом вызывает проблемы.

Вот у Дмитрия Котова есть модуль Динамическое формирование интерфейса.

Но в нем есть одна проблема, как раз с неймингом.

Модуль занимается созданием элементов и автор везде сокращает наиболее часто встречающуюся часть команды Создать до сзд:

ДФИ.сздГруппаОбычнаяБезОтображения
ДФИ.сздГруппаОбычная

Но нюанс в том, что все вызывается из общего модуля ДФИ, поэтому Создать можно было бы вообще не писать:

ДФИ.ГруппаОбычнаяБезОтображения
ДФИ.ГруппаОбычная

Нэйминг неудачный вышел.

image_pdfimage_print

fixin

Программирую на 1С с 1999 года. В 1С просто Гений. В 2020 году ушел из офиса на вольные хлеба фриланса. Принимаю заказы.

Вам может также понравиться...

комментариев 6

  1. Serg:

    Буквоедство — болезнь мозга, как говорит один «гений». Верим?
    Если по теме — а что неудачного-то в сзд? ГруппаОбычная — разве очевидно, что метод создаëт, а не возвращает например?

    • сзд в пределах контексте ДФИ лишнее.
      лишние буквы.
      и ведь автор писал не для себя, а для всех.
      я в F3 убрал лишние буквы.

      • Serg:

        Но почему лишние? Аббревиатура ДФИ ничего не говорит сама по себе, а вот Сзд сразу понятно, что метод создаëт. Разработчик, который впервые увидит это в коде, сразу поймëт, что здесь что-то создаëтся.

        • писать дольше. а разработчик зайдет в модуль и пойдет. Зато потом ему это сзд будет глаз мозолить.

          • Serg:

            Я так понимаю, в IDE есть автоподстановка, тогда писать не дольше. Заходить в модуль может быть лишним действием, если из названия метода всё понятно, то и заходить не требуется. Насчёт мозолить тут уже вкусовщина, на мой взгляд.

          • ДФИ уже признак создания элементов. сзд такой себе префикс. Писали бы уже тогда Создать. Но в любом случае, Создать или сзд тут лишнее.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *