Какие софт-скиллы приходят вам в голову, когда вы составляете своё резюме? Стрессоустойчивость, коммуникабельность, многозадачность?

Это всё здорово и безусловно полезно, но есть одно не самое очевидное качество, которое очень пригодится техническому писателю — Адаптивность

Представьте, вы организовали процесс документирования в команде, развернули вашу доку в docs-as-code. Всё красиво, хорошо и прекрасно работает.

Но наступает день, когда к вам приходят коллеги (или даже начальство) и говорят: нам не нравится/неудобно/долго пользоваться вашим гитом, мы устали откалывать ветки и мержить мерж реквесты! Мы хотим старый добрый конфлюенс!

И у вас есть два пути: повести себя как хороший родитель или повести себя как эффективный управленец.

Как хороший родитель вы можете продолжать защищать своего сынульку принятые вами решения и организованные вами процессы: доказывать их преимущества, убеждать коллег и руководство в крутости выбранного подхода.

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

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

Да, бывает больно отказываться от любовно настроенного инструмента, работающего как часы. Но как приятно смотреть на коллег, которым легко и удобно пользоваться твоей докой!

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

Но как прокачать это умение?

Рецепта нет. Есть отличное правило из agile-манифеста, которому я стараюсь следовать:

Люди и их взаимодействие важнее, чем процессы и инструменты

Если в парке наперекор асфальтовой дорожке по газону протоптана тропинка, скорее всего она и есть самый оптимальный путь до калитки. Вот я и стараюсь вовремя разглядеть такие тропинки на газоне наших документационных процессов и по возможности включать их в пешеходные парковые маршруты.

Обращайте внимание на тропинки, благоукрашайте свой парк и работайте на радость и комфорт ваших пользователей)

#практика