Size: a a a

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

2020 July 23

NV

Nick Volynkin in DocOps-сообщество
Я имел в виду что Гипербатон смотрят айтишники, которые наверняка работают из дома, так что пробки не должны им помешать.
источник
2020 July 24

MS

Mikhail Sapozhnikov in DocOps-сообщество
Я пока не стану останавливать голосование, но уже и сейчас видно, что три темы (1,4,5) лидируют. Потому ими и ограничимся. Следующий zoom пройдет не в четверг, как обычно, а в среду 29 июля в 20:00 MSK. Кто чувствует в себе силы и желание выступить экспертом, пишите мне в личку @mxsmirnov
источник

MS

Mikhail Sapozhnikov in DocOps-сообщество
Темы панели "Архитектура и документация"
Анонимный опрос
24%
Как связаны между собой описание архитектуры и документация
10%
Что так, а что не так с ISO 42010 (ГОСТ Р 57100)
15%
Заинтересованные лица и варианты использования архитектуры
25%
Модели и диаграммы. Когда появится API архитектурного репозитория?
25%
Каким станет описание архитектуры к 2025 году
Проголосовало: 700
источник

MS

Mikhail Sapozhnikov in DocOps-сообщество
Mikhail Sapozhnikov
YouTube
Непрерывное применение архитектурных практик как способ снижения рисков / Александр Лучков
Проблема документирования технических решений обсуждается часто, долго и с большими разногласиями. Широко распространены в зависимости от отрасли два лагеря "формалисты-бюрократы" и "гибкие-либералы".
Из моего опыта аргументы вторых сводятся к утверждениям  похожим на:
- "Документация устаревает быстрее, чем обновляется, поэтому в ИТ системе единственная актуальная документация - это код"
- "Документация нужна только там, где нужно её сдавать. Поэтому необходимо писать только ту документацию, которая указана в контракте"
- "Документация - это дорого и поэтому лучше делать продукт интуитивным"
- "Формализмы - это затраты на их изучение, а рынок настолько широк, что невозможно научить всех. Поэтому лучше писать каждый как умеет."

Первые же говорят о том, что:
- "Хорошая документация должна быть"
- "Документация делает процесс разработки управляемым"
- "При хорошей документации RTFM является эффективным способ обучения сотрудников"
- "Документация обеспечивает возможность поддерживать качество продукта…
В продолжение
источник

СФ

Семён Факторович... in DocOps-сообщество
Mikhail Sapozhnikov
Темы панели "Архитектура и документация"
Анонимный опрос
24%
Как связаны между собой описание архитектуры и документация
10%
Что так, а что не так с ISO 42010 (ГОСТ Р 57100)
15%
Заинтересованные лица и варианты использования архитектуры
25%
Модели и диаграммы. Когда появится API архитектурного репозитория?
25%
Каким станет описание архитектуры к 2025 году
Проголосовало: 700
крутяк!
источник

NV

Nick Volynkin in DocOps-сообщество
Mikhail Sapozhnikov
В продолжение
О, это очень интересно
источник

RK

Ruslan Kosolapov in DocOps-сообщество
День добрый.  Тут недавно был сюрвей на тему хостинга документации, обобщённые результаты можно посмотреть здесь: https://docs.google.com/document/d/16gtkNxEBIYwtC6zWWg8C6M_dq_Wd292i5m0Z2wAQQUo/edit?usp=sharing

Изначально обещал адресно рассылать, но это зело неудобно, так что шарю на всех.  Не знаю, насколько полезно вам, но нам было полезно, спасибо всем поучаствовавшим.
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
Коллеги, с вами регулярная рубрика "хочу странного" 🙂

Сталкивались ли вы с задачей построения карты взаимодействия сервисов, желательно — автоматизированно?
Кажется, это называется "distributed tracing" и "распределённая трассировка", но как будто тема ещё молодая.
источник

DB

Dima Boger in DocOps-сообщество
Игорь Цупко
Коллеги, с вами регулярная рубрика "хочу странного" 🙂

Сталкивались ли вы с задачей построения карты взаимодействия сервисов, желательно — автоматизированно?
Кажется, это называется "distributed tracing" и "распределённая трассировка", но как будто тема ещё молодая.
Видели-слышали) Jaeger, opentracing, вот это вот всё
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
трогали?
источник

DB

Dima Boger in DocOps-сообщество
Трогали
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
а расскажите?
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
как использовали? топологию строили?
источник

DB

Dima Boger in DocOps-сообщество
Я не видел про топологию, почти везде использовали как инструмент отслеживания "плохих запросов" — у нас большая вложенность очень разнообразных сервисов с единой точкой входа, поэтому если какой-то из них ведёт себя плохо, то мы можем отследить запрос и посмотреть в каком месте ему стало плохо. В общем-то на этом и интеграции в код мои познания кончаются)
источник

ЕД

Егор Доронин... in DocOps-сообщество
Игорь Цупко
Коллеги, с вами регулярная рубрика "хочу странного" 🙂

Сталкивались ли вы с задачей построения карты взаимодействия сервисов, желательно — автоматизированно?
Кажется, это называется "distributed tracing" и "распределённая трассировка", но как будто тема ещё молодая.
Это сейчас модная тема - "Observability"
источник

NV

Nick Volynkin in DocOps-сообщество
Ruslan Kosolapov
День добрый.  Тут недавно был сюрвей на тему хостинга документации, обобщённые результаты можно посмотреть здесь: https://docs.google.com/document/d/16gtkNxEBIYwtC6zWWg8C6M_dq_Wd292i5m0Z2wAQQUo/edit?usp=sharing

Изначально обещал адресно рассылать, но это зело неудобно, так что шарю на всех.  Не знаю, насколько полезно вам, но нам было полезно, спасибо всем поучаствовавшим.
Спасибо )
источник

NK

ID:0 in DocOps-сообщество
Дайджест чата и результаты исследования.

Лана Новикова написала дайджест чата @docsascode за июнь. Там куча полезных ссылок, которые не попали в канал. https://teletype.in/@lananovikova/docops-june. Читайте и приходите в чат с вопросами, идеями и новостями.

Руслан Косолапов опубликовал итоги исследования про хостинг документации, о котором я недавно писал. Из интересного: респонденты либо не знают точные затраты на хостинг, либо уверены что они меньше $100 в месяц. А ещё, канал @docops — один из основных источников информации о хостинге документации :)
источник

NK

ID:0 in DocOps-сообщество
​​Хороших статей вам на выходные.

Настя Дмитриева из «Актива» начала серию статей про то, как в компании пишут пользовательскую документацию. Первая статья — про стоимость разработки документа и людей, которые участвуют в разработке.

Катя Носкова из Xsolla написала про онбординг технических писателей. По статье можно учиться онбордингу кого угодно, особенно если тема для вас совсем новая.

(Если вы не узнали, Xsolla — это те самые ребята в авангарде непрерывной локализации, которые внедрили Serge, когда это ещё не было мейнстримом.)
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
Игорь Цупко
Коллеги, с вами регулярная рубрика "хочу странного" 🙂

Сталкивались ли вы с задачей построения карты взаимодействия сервисов, желательно — автоматизированно?
Кажется, это называется "distributed tracing" и "распределённая трассировка", но как будто тема ещё молодая.
вооот, похоже нашёл что-то близкое именно к "по-быстрому взял и оформил" https://icepanel.io/
источник

НН

Нац Нац in DocOps-сообщество
еще и вскодное расширение!
источник