Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Мария Смирнова – Дзен и искусство работы с доку...

Ozon Tech
December 12, 2023

Мария Смирнова – Дзен и искусство работы с документацией: как использовать принципы буддизма в работе техписа

Ozon Tech

December 12, 2023
Tweet

More Decks by Ozon Tech

Other Decks in Technology

Transcript

  1. Дзен и искусство работы с документацией Мария Смирнова Руководитель группы

    пользовательской документации Как использовать принципы буддийского учения в работе техписа
  2. Это я Про докладчика 3 • Филолог-германист • 7 лет

    в переводах и локализации • Работала в бюро переводов и англоязычной техподдержке • В поисках себя пришла к техническому писательству • И немножко к буддизму
  3. Про то, зачем мне буддизм 4 Симпатичная мне философская концепция

    Инструмент для успокоения ума Объяснение мира и красивые аналогии
  4. Формат доклада 5 Буддийский пример* Рассказываю историю 
 или пример

    из концепции Техписательская расшифровка Рассказываю, какие параллели с техническим писательством я в этом вижу *Без эзотерики и абстрактных рассуждений
  5. Как Будда стал Буддой, а техпис — техписом 7 1.

    Живёт спокойно 2. Сталкивается с реальностью 3. Понимает, что так жить нельзя 4. Ударяется в перфекционизм 5. Приходит к золотой середине
  6. По-буддийски и по-техписательски Четыре благородные истины 8 Жизнь есть страдание

    У него есть причины Страдание можно прекратить Ключ — 
 в срединном пути В мире куча плохой документации Мы сами иногда/ часто её пишем Это можно исправить Ключ — 
 в золотой середине
  7. 11 Вы разгребаете ту судьбу, 
 которую сами создали, 


    постепенно пробираясь 
 к духовному началу. Или к достаточно хорошей 
 документации.
  8. Истинные страдания 13 По-буддийски • Несчастье • Краткосрочное счастье •

    Постоянно повторяющиеся проблемы По-техписательски • Документация никогда не будет идеальной • Начинает устаревать в момент публикации • Всё нужно объяснять по десять раз
  9. Смиритесь с тем, 
 что идеально не будет 14 Никогда.

    Вообще. Совсем. • Документация никогда не будет идеальной • Но можно добиться достаточно хорошей • Налаживайте процессы и фиксируйте 
 правила в источниках истины
  10. Истинная причина страданий 15 По-буддийски • Беспокойный ум и эмоции

    • Непонимание мироустройства • Неспособность видеть взаимосвязи По-техписательски • Перфекционизм и многозадачность • Непонимание процессов • Невнимательность к коллегам и заказчикам
  11. Будьте милосердны 
 к коллегам и заказчикам 16 А ещё

    помните, что karma is a bitch • Планируйте свою работу • Проводите подробный ресёрч • Фиксируйте правила и договорённости, 
 чтобы не спорить по пустякам
  12. Истинное прекращение страданий 17 По-буддийски • Очистить ум • Обуздать

    эмоции • Постоянно поддерживать 
 высшее состояние По-техписательски • Выстроить процессы • Понимать приоритеты • Быть последовательным
  13. Не суетитесь 18 • Применяйте то, что фиксируете, на практике

    • Расписывайте процессы, рисуйте схемы • Всегда уточняйте, насколько на самом деле задача срочная
  14. Истинный путь ума 19 По-буддийски • Видеть полную картину •

    Осознавать последствия своих действий • Осознать взаимосвязь со всеми существами По-техписательски • Видеть полную картину • Осознавать последствия своих действий • Осознать взаимосвязь со всеми существами* *Как то: коллеги, продукты, разработчики, пользователи…
  15. Сделайте всё это частью себя и своей повседневности 20 •

    Плохая новость: придётся постоянно напоминать себе о высших истинах • Хорошая новость: при постоянной практике напоминаний будет требоваться 
 всё меньше
  16. 21 1. Смиритесь с несовершенством документации 2. Будьте внимательны и

    последовательны во всех аспектах 3. Успокойтесь и не суетитесь. Не бойтесь больше ресёрчить 4. Не расстраивайтесь, если что-то идёт не так 5. Всегда держите в голове цели, ЦА и место размещения документации