После недели общения с лидерами сообщества OpenStack, прохождения обучения лидерству, я вдохновлен изложить идеи из книги Influencer: The New Science of Leading Change. Для меня, которому нужно максимально использовать усилия сообщества, идея о том, что никто не любит, когда ему говорят, что делать, была знакомой фразой. Вместо этого заставьте людей принять ваше видение и дополнить его.

Например, меня часто спрашивают, как вы мотивируете людей писать документацию для проектов с открытым исходным кодом? Или написать для любого программного проекта?

Получите подробную информацию о поведении, которое вы хотите увидеть

Используя структуру, предлагаемую в этой книге, вы сначала должны определить поведение, которое хотите видеть. Их примеры часто связаны со здравоохранением, например, с мытьем рук. Но вы можете очень подробно рассказать о мытье рук, например, где, когда и как. Для документации вы можете сказать, что это поведение «запись», но я хочу уточнить это. Куда им писать? Является ли поведение «написать личный пост в блоге»? Или это «написать в официальных документах»?

Кроме того, когда они должны писать? В идеале как можно ближе к моменту, когда технические детали еще свежи. «Когда» может быть в конце цикла, когда люди меньше отвлекаются на добавление функций. Или напишите документацию до того, как будет написан код, и часто пересматривайте ее.

Что касается того, «как» мы хотим, чтобы участники писали, что ж, нам могут понадобиться шаблоны и рамки для «как» — такие как исходные форматы, задания сборки и в каком репозитории.

Глядя на поведение, которое мы хотим видеть, подробно описывая его, мы обнаруживаем, что мы также хотим поощрять поведение рецензентов кода читать и просматривать соответствующие документы.

Определите решающий момент

Теперь, когда часть кода меняется, что влияет на документацию, это решающий момент для влияния на конкретное поведение. Поведение, которое мы хотим видеть, — это написание документации, пока код свеж в вашей памяти.

Еще один важный момент для вовлечения — это когда пользователь впервые пробует функцию; их свежий взгляд может предоставить обновление документов, которое другие могут не увидеть. Функция «Редактировать на GitHub» для создания запроса на вытягивание предоставляет возможность свежему взгляду быстро внести изменения в документацию.

Итак, у нас есть представление о поведении, которое мы хотим видеть, и ощущение, когда мы хотим его увидеть. Теперь мы можем начать спрашивать, что мешает такому поведению.

Почему люди не вносят свой вклад?

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

Обеспечьте руководство и энергию

Кроме того, люди связывают скуку с документами. Они смотрят на пустой экран и не могут подобрать слов, чтобы описать свою особенность. Они зевают и проверяют свою ленту в Твиттере вместо того, чтобы писать документы. В этом больном месте могут помочь шаблоны. Людям, которые не знают, что писать, могут понадобиться рекомендации, предложения или строгие шаблоны на основе форм.

Избегайте переключения контекста

Очень неприятно иметь набор инструментов для документации, который сильно отличается от того, в котором вы пишете код — переключение контекста даже на веб-редактор может быть слишком большим препятствием, чтобы его перепрыгнуть. Делайте документы похожими на код всякий раз, когда вам нужно заставить разработчиков писать.

Получите несколько влиятельных лиц, которые верят в видение

Без фактического давления со стороны сверстников, которое говорит «да, мы пишем документы», разработчики могут не создать культуру, требующую документации. Начните с лидеров мнений из их группы сверстников (возможно, это не вы). Например, когда исследователь семян хочет представить новый гибрид семенной кукурузы, он идет прямо в местную закусочную, где по субботам завтракает самый опытный и влиятельный фермер. Лучше, чтобы фермер в своем пикапе понял и поверил в преимущества перехода на новую гибридную семенную кукурузу, чем исследователь в своей последней модели Volvo.

Предлагайте преднамеренные практические занятия

Также рассмотрите «преднамеренную практику», когда вы выделяете время, чтобы улучшить навык. Если навык письма, то проводите рабочие часы или коуч-сессии в Интернете, а на конференциях убедитесь, что вы можете встретиться с людьми, которые хотят стать лучшими писателями, чтобы показать им, как практиковать письмо с помощью упражнений, упражнений и веселых совместных усилий, таких как док-спринты. Запишите видео или организуйте онлайн-встречу, показав все шаги для преднамеренного и стратегического участия.

Спасибо многим коллегам, которые помогали мне обсуждать и обдумывать эти идеи по ходу дела. Какие есть дополнительные способы повлиять на желаемый результат?