Size: a a a

DocOps-сообщество

2020 December 28

NV

Nick Volynkin in DocOps-сообщество
Коллеги, а знает ли кто-нибудь руководство по reStructuredText на русском языке? Я просмотрел свои закладки, но ничего не нашёл.
источник

E

Ekaterina in DocOps-сообщество
Из русскоязычных только этот ресурс у себя в закладках нашла.
https://sphinx-ru.readthedocs.io/ru/latest/rst-markup.html#id2
источник

NV

Nick Volynkin in DocOps-сообщество
Ekaterina
Из русскоязычных только этот ресурс у себя в закладках нашла.
https://sphinx-ru.readthedocs.io/ru/latest/rst-markup.html#id2
Спасибо!
источник
2020 December 29

NK

ID:0 in DocOps-сообщество
Подборка хороших сайтов с документацией, чтобы черпать вдохновение и красть, как художник: https://devportalawards.org/
источник

L

Lejbron in DocOps-сообщество
ID:0
Екатерина Носкова из Xsolla рассказала про аналитику в документации. И не просто о сырых данных вроде количества просмотров, а о метриках, привязанных к реальной пользе для бизнеса. Это очень круто, читаю и восхищаюсь.

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

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

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

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

NV

Nick Volynkin in DocOps-сообщество
Lejbron
Отличная статья, было действительно любопытно, спасибо за труд!
@koshatneg тебе спасибо говорят )
источник

L

Lejbron in DocOps-сообщество
Забыл тегнуть, сори)
источник

EN

Ekaterina Noskova in DocOps-сообщество
ого, спасибо)
источник
2020 December 31

NK

ID:0 in DocOps-сообщество
С новым годом, друзья! :)
источник

KG

Kamilla Garifullina in DocOps-сообщество
ID:0
С новым годом, друзья! :)
С наступающим!
источник

RZ

Roman Zh in DocOps-сообщество
ID:0
С новым годом, друзья! :)
источник

P

Patience in DocOps-сообщество
ID:0
С новым годом, друзья! :)
Хороший какой совец :) с наступающим!
источник
2021 January 07

NK

ID:0 in DocOps-сообщество
источник

NK

ID:0 in DocOps-сообщество
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
источник

NK

ID:0 in DocOps-сообщество
Вообще, смешно и грустно, что к половине статей про документацию берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным. Как будто основная работа технического писателя в том, чтобы писать. Вот нифига, основная работа — думать и исследовать. Как и у разработчика и у кучи других профессий. Когда хорошо подумаешь, писать несложно.
источник

T

Taisiia in DocOps-сообщество
ID:0
Вообще, смешно и грустно, что к половине статей про документацию берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным. Как будто основная работа технического писателя в том, чтобы писать. Вот нифига, основная работа — думать и исследовать. Как и у разработчика и у кучи других профессий. Когда хорошо подумаешь, писать несложно.
Святая правда
источник

T

Taisiia in DocOps-сообщество
Что такое runbook documentation?
источник

NV

Nick Volynkin in DocOps-сообщество
Taisiia
Что такое runbook documentation?
Набор инструкций по эксплуатации сервиса. Их пишут и используют админы или SRE (site/service reliability engineer).
источник

T

Taisiia in DocOps-сообщество
👍
источник

СФ

Семён Факторович... in DocOps-сообщество
ID:0
Вообще, смешно и грустно, что к половине статей про документацию берут иллюстрацию с клавиатурой, печатной машинкой, пером и чернильницей или чем-то подобным. Как будто основная работа технического писателя в том, чтобы писать. Вот нифига, основная работа — думать и исследовать. Как и у разработчика и у кучи других профессий. Когда хорошо подумаешь, писать несложно.
Давайте придумаем себе (в смысле, нашей профессии) набор визуальных образов?
источник