DocOps

2021-01-17 10:33:57 Всем ГОСТописателям рекомендую слушать выпуск «Нового подкаста» про AsciiDoc и его использование в компании КУРС. Переходите уже к нам на светлую сторону, у нас docs-as-code и печеньки.

Ссылки на все платформы: https://newpodcast2.live/podcast/vanya-and-asiidoc/ Открыть/Комментировать

2021-01-08 09:44:28 Таня @rishavant запустила анонимный опрос о зарплатах UX-писателей. Если вы пишете интерфейсные тексты — пожалуйста, ответьте на пару вопросов. Результаты Таня потом опубликует.

https://forms.gle/gJD8Q9zVzmUP3Zbd9 Открыть/Комментировать

2021-01-07 19:05:02 Писателям тоже будет полезно. https://www.transposit.com/blog/2020.01.30-writing-runbook-documentation-when-youre-an-sre Открыть/Комментировать

2021-01-07 19:01:51 Writing Runbook Documentation When You’re An SRE

Tips and tricks for writing effective runbook documentation when you aren’t a technical writer

https://www.transposit.com/blog/2020.01.30-writing-runbook-documentation-when-youre-an-sre Открыть/Комментировать

2021-01-07 19:01:51 Писателям тоже будет полезно.

https://www.transposit.com/blog/2020.01.30-writing-runbook-documentation-when-youre-an-sre Открыть/Комментировать

2020-12-31 20:09:22 С новым годом, друзья! :) Открыть/Комментировать

2020-12-29 06:37:34 Подборка хороших сайтов с документацией, чтобы черпать вдохновение и красть, как художник: https://devportalawards.org/ Открыть/Комментировать

2020-12-14 09:29:21 Екатерина Носкова из Xsolla рассказала про аналитику в документации. И не просто о сырых данных вроде количества просмотров, а о метриках, привязанных к реальной пользе для бизнеса. Это очень круто, читаю и восхищаюсь.

Xsolla — это платёжная система для игр и других приложений. Вот какие бизнес-метрики есть в доке Xsolla:

— Доля интеграций (внедрений платёжных инструментов Xsolla), которые клиенты сделали своими силами, не напрягая техподдержку.
— Изменение затрат на техническую поддержку, когда пользователь или сотрудник поддержки находят готовое решение в доке.

И внутренние метрики, показатели здоровья доки:
— Посещаемость по типу аудитории (b2b, b2c), языку и продукту. Просто суммарная посещаемость не имеет смысла, важны разрезы.
— Средняя скорость загрузки страниц. Это влияет сразу на UX и SEO.
— Индекс удовлетворённости пользователей — считается через форму фидбека / .
— Качество документации, измеренное по нескольким показателям.
— Юзабилити документации — по анализу тепловых карт и записей сессий.

Читайте статью целиком, там много полезных идей. https://medium.com/xsolla-tech/analytics-in-documentation-d814bbbe6ea6 Открыть/Комментировать

2020-12-11 20:55:06 Смотри. У тебя на самом деле не ноль лет опыта, потому что важен и полезен много какой опыт.

Есть общие навыки работы с информацией. Понимать незнакомое, структурировать, выделять связи, объяснять, излагать текстом.

Есть софт-скиллы. Учиться. Принимать обратную связь, в том числе негативную. Давать обратную связь, тоже в том числе негативную. Организовывать свой труд. Расставлять приоритеты. Писать понятные письма. Задавать вопросы — понятые, полные, открытые вопросы, это очень редко кто умеет. Рефлексировать. Отдыхать. Печатать десятью пальцами и вслепую. Договариваться с людьми, передоговариваться. Давать обещания, держать обещания, требовать по обещаниям тебе. Благодарить и принимать благодарность. Ошибаться и идти дальше, извлекать опыт из ошибок, своих и чужих. Давать задачи, брать задачи, руководить и быть руководимой. Сообщать заранее, когда не успеваешь сделать задачу в срок. Обращаться за помощью. Понимать других людей, их эмоции, цели, доступные им знания.

Всё это ты уже насколько-то умеешь. Это твой опыт. Он не нулевой. И всё это настолько же важно в работе, как и знание предметной области и специфических писательских инструментов. Даже больше: предметной области тебя любая компания легко научит. А вот софт-скиллам учить сложно и больно. У тебя они уже развиты и это твоя сильная сторона. Открыть/Комментировать

2020-12-11 20:55:06 Писал это знакомой, которая хочет перейти в технические писатели. Но это верно для всех, кто в свои ХХ лет хочет поменять профессию и сомневается, что это можно сделать, не имея опыта.

Я в вас верю, вы сможете. Открыть/Комментировать