Комментировать в обзоре кода - это управление
Рассматривайте комментарии как инструмент управления
Вставка комментариев в обзор кода является формой управления. Как таковой, он должен рассматриваться как инструмент управления.
Используйте управленческие практики при комментировании
Существует структура управления людьми, целью которой является достижение желаемого результата. Некоторые из основных подходов к управлению не будут применяться в комментариях, но большинство из них. Применимые темы включают среду, лидерство, организацию и контроль.
Среда
культура
Окружающая среда диктует стиль управления. Культура и окружение на рабочем месте следует учитывать при использовании любых инструментов управления. Обычно это зависит от отрасли и размера управляемой компании или организации.
Стиль
Если есть беззаботная культура, то это может встретиться в используемом стиле управления. Если существуют очень строгие правила, политика и последствия, это должно быть отражено в используемом стиле. Так что, если все находятся на борту ради шутки в «Звездных войнах», ссылающейся на дроидов и слабовидного штурмовика, тогда может быть применимо комедийное междометие. Однако, если есть серьезные последствия несерьезного отношения к конечному результату, его, возможно, следует избегать.
руководство
основы
Есть три основных столпа лидерства, которые необходимо учитывать при комментировании. А именно, это видение, общение и суждение.
Vision
Важно, когда нужно помнить о великом видении, объясняя или давая инструкции. В комментариях это может означать указание на то, как небольшие изменения влияют на проект в целом, каковы последствия применения различных подходов или намеки на разделение интересов.
Communication
Быть хорошим коммуникатором важно во многих аспектах жизни. Это не отличается в комментариях. Важно использовать мудрый уровень краткости, особенно потому, что комментарии не должны занимать много места. Приступайте к делу пораньше, а затем, при необходимости, подкрепите ее примером. В более крупной организации это может также включать необходимость рассылки коммюнике или записки, если проблема не локализована для одного сеанса проверки.
Judgement
Важно, чтобы стратегия использовалась при оценке того, нужно ли делать комментарии, и каковы должны быть изменения. Ваше суждение не всегда должно быть правильным, но оно должно быть последовательно правильным, особенно когда делаются большие суждения.
Организация
С управленческой точки зрения организация подразумевает сохранение конечной цели и обеспечение согласованности процессов в соответствии с набором правил. Комментарии также должны учитывать это, поскольку комментарии должны по возможности основываться друг на друге, чтобы обеспечить соблюдение последовательности разработки. Также будет важно иметь в виду объем проверяемого кода, чтобы уменьшить взаимосвязь и следовать общему дизайну.
управление
Управление действиями тех, кто управляется, является деликатным процессом. Будучи твердым, следует также помнить, что люди важны. Есть несколько управленческих навыков, которые можно использовать, контролируя других. Эти навыки являются политическими, концептуальными, межличностными, диагностическими и техническими.
политическая
Политику можно найти в любое время, когда есть взаимодействие между людьми. Это огромная тема, но в общем смысле политика вращается вокруг влияния. При составлении комментария важно учитывать личную и профессиональную политику на работе. Это может быть связано с инструкцией, шуткой или даже вопросом.
концептуальный
Управление через концептуализацию является важным инструментом. Это требует комплексного анализа ситуации под рукой. При комментировании может быть полезно включить часть анализа, использованного для получения заключения или изменения, указанных в обзоре.
Межличностные
Навыки межличностного общения очень важны при управлении. Это тоже большая тема. Некоторые из важных вещей, которые следует учитывать с навыками межличностного общения, наставничество, конструктивная критика и "гарпун".
Mentoring
Важно, чтобы управление воспринималось скорее как наставник, чем как антагонист. В обзоре кода это означает, что иногда будет полезно включить дань в шаблон проектирования или подход, который можно использовать для улучшения ситуации.
Constructive Criticism
Критика важна, потому что она вызывает рефлексию. Тем не менее, критика должна быть максимально позитивной, когда это возможно. Это означает предоставление достоверных доказательств в поддержку критики, а также обеспечение того, чтобы используемый тон не был отрицательным. При просмотре кода это может включать показ исключения или возможного сценария, который может привести к ошибке при нахождении решения, вместо того, чтобы показывать каждое место, которое было неправильным, когда весь кусок кода необходимо было бы заменить в любом случае.
"Harpooning"
«Гарпунирование» - это когда вы образно гарпуните кого-то на землю. Это делается путем разрушения их шаг за шагом без каких-либо передышек до тех пор, пока они не почувствуют себя неспособными встать. Если вы используете человека при проверке кода или в другом месте, вы потеряете его сотрудничество. Важно избегать чрезмерного разрушения.
Управляющее резюме
Рассматривайте комментарии в обзоре кода как инструмент управления. Имейте в виду, что комментарии должны быть краткими, конкретными и конструктивными. Также убедитесь, что при комментировании проверяемое лицо принимается во внимание.