Теория не всегда стакается с практикой.

Дано: Есть конструктор документа. Он состоит из 5 объёмных шагов. В UI указаны все номера шагов и помечен шаг, на котором находится пользователь.

Как лучше назвать компоненты, которые соответствуют шагам? Step1, Step2, Step3 и т.д.
Или SetRepresented, SetRepresentative, SetPermision...

В теории: АРЯЯЯЯ ЛУЧШЕ НАЗЫВАТЬ ПО СМЫСЛУ ШАГА, А НЕ ПО НОМЕРУ. НАЗВАНИЕ ОТРАЖАЕТ БИЗНЕС-ДЕЙСТВИЕ.

На практике:
> Прибегает аналитик и говорит, что на шаге 3 в конструкторе баг, надо исправить
> Ты спрашиваешь "шаг 3 это какой?" (не лезть же в код, чтобы в родительском компоненте посмотреть, что там на 3-ей позиции)
> Он тебе говорит "НУ ЭТО ТАМ, ГДЕ РЕПРЕСЕНТЕД УСТАНАВЛИВАЕТСЯ"
> Ищешь SetRepresented, который спрятался между SetRepresentative, SetReplied, SetReported.
> Компоненты расположились в IDE по алфавиту, поэтому первый шаг лежит 4-ым, а последний вторым.

По факту, всё будет быстрее, если назвать компоненты Step1, потому что и клиент и аналитик первым делом выдадут номер шага, а не бизнес-смысловое название. Потому что ты первым делом вспомнишь номер шага, а не бизнес-смысловое название.

Эмпирика-пракитка > Теория из книжек-хуижек.