Какие софт-скиллы приходят вам в голову, когда вы составляете своё резюме? Стрессоустойчивость, коммуникабельность, многозадачность?
Это всё здорово и безусловно полезно, но есть одно не самое очевидное качество, которое очень пригодится техническому писателю — Адаптивность
Представьте, вы организовали процесс документирования в команде, развернули вашу доку в docs-as-code. Всё красиво, хорошо и прекрасно работает.
Но наступает день, когда к вам приходят коллеги (или даже начальство) и говорят: нам не нравится/неудобно/долго пользоваться вашим гитом, мы устали откалывать ветки и мержить мерж реквесты! Мы хотим старый добрый конфлюенс!
И у вас есть два пути: повести себя как хороший родитель или повести себя как эффективный управленец.
Как хороший родитель вы можете продолжать защищать своего сынульку принятые вами решения и организованные вами процессы: доказывать их преимущества, убеждать коллег и руководство в крутости выбранного подхода.
Как эффективный управленец вы можете проанализировать претензии коллег, провести внутренний аудит док.системы и, признав недостатки выбранных вами решений, пересмотреть их и внести конструктивные изменения.
Я почти два года работаю на большом проекте и постоянно держу руку на пульсе — слежу за тем, куда дует ветер, слушаю людей вокруг себя и стараюсь сохранить в своей док.системе главное её качество — умение прогнуться под изменчивый окружающий её мир.
Да, бывает больно отказываться от любовно настроенного инструмента, работающего как часы. Но как приятно смотреть на коллег, которым легко и удобно пользоваться твоей докой!
Я не хочу сказать, что нужно при каждом чихе и недовольном повороте коллегской головы срочно реорганизовывать прекрасно работающие и утверждённые процессы, вовсе нет. Тут требуется гораздо более тонкий навык — научиться чувствовать, что пришло время что-то менять.
Но как прокачать это умение?
Рецепта нет. Есть отличное правило из agile-манифеста, которому я стараюсь следовать:
Если в парке наперекор асфальтовой дорожке по газону протоптана тропинка, скорее всего она и есть самый оптимальный путь до калитки. Вот я и стараюсь вовремя разглядеть такие тропинки на газоне наших документационных процессов и по возможности включать их в пешеходные парковые маршруты.
Обращайте внимание на тропинки, благоукрашайте свой парк и работайте на радость и комфорт ваших пользователей)
#практика
Это всё здорово и безусловно полезно, но есть одно не самое очевидное качество, которое очень пригодится техническому писателю — Адаптивность
Представьте, вы организовали процесс документирования в команде, развернули вашу доку в docs-as-code. Всё красиво, хорошо и прекрасно работает.
Но наступает день, когда к вам приходят коллеги (или даже начальство) и говорят: нам не нравится/неудобно/долго пользоваться вашим гитом, мы устали откалывать ветки и мержить мерж реквесты! Мы хотим старый добрый конфлюенс!
И у вас есть два пути: повести себя как хороший родитель или повести себя как эффективный управленец.
Как хороший родитель вы можете продолжать защищать своего сынульку принятые вами решения и организованные вами процессы: доказывать их преимущества, убеждать коллег и руководство в крутости выбранного подхода.
Как эффективный управленец вы можете проанализировать претензии коллег, провести внутренний аудит док.системы и, признав недостатки выбранных вами решений, пересмотреть их и внести конструктивные изменения.
Я почти два года работаю на большом проекте и постоянно держу руку на пульсе — слежу за тем, куда дует ветер, слушаю людей вокруг себя и стараюсь сохранить в своей док.системе главное её качество — умение прогнуться под изменчивый окружающий её мир.
Да, бывает больно отказываться от любовно настроенного инструмента, работающего как часы. Но как приятно смотреть на коллег, которым легко и удобно пользоваться твоей докой!
Я не хочу сказать, что нужно при каждом чихе и недовольном повороте коллегской головы срочно реорганизовывать прекрасно работающие и утверждённые процессы, вовсе нет. Тут требуется гораздо более тонкий навык — научиться чувствовать, что пришло время что-то менять.
Но как прокачать это умение?
Рецепта нет. Есть отличное правило из agile-манифеста, которому я стараюсь следовать:
Люди и их взаимодействие важнее, чем процессы и инструменты
Если в парке наперекор асфальтовой дорожке по газону протоптана тропинка, скорее всего она и есть самый оптимальный путь до калитки. Вот я и стараюсь вовремя разглядеть такие тропинки на газоне наших документационных процессов и по возможности включать их в пешеходные парковые маршруты.
Обращайте внимание на тропинки, благоукрашайте свой парк и работайте на радость и комфорт ваших пользователей)
#практика