А вот тут классный пример про 16к связей! На таком объёме это действительно может быть полезно. Но тут нюанс со сферой деятельности. Я имел минимальный опыт с описанием схем на VHDL, и по моим ощущениям это всё же больше программирование как таковое, нежели именно рисование. Потому тут подходы работы с кодом действительно актуальнее.

>Инструментарий прямо скажем убогенький
А про какой инструментарий идёт речь?

мне если честно, вообще странно в 2020-м году видеть всерьёз какое-то обсуждение о том, что к документации можно относиться хоть как-то кроме  как к исходникам, из которых генерируются различные представления.

Основной объём работы техписа  — текст. То, что скринкасты и скриншоты пока нет особой практики генерировать скриптами — это недоработка инструментария.

Почти всё сводится к простому тексту.

Инструментально техписатели очень близки к девелоперам.

я про графические клик-клик инструменты. Они могут быть удобны для одного человека,  сидящего у компьютера, но начинают разламываться как только начинает работать два человека

Как вариант есть такое видение:
https://idratherbewriting.com/2017/06/02/when-docs-are-not-like-code/

Поэтому выше я и писал о том, что у каждого свои подходы и условия.

Порисовал, но не в проде, потому что в нём всё "по старинке".

Мне нравится. Я вообще люблю всё as a code =)

Скажите это тем, кто до сих пор пишет в ворде и: re: (re:(re..))

Ещё раз спрошу, как насчёт онлайн-конфы? Мы так смогли бы охватить слушателей не в дефолт-сити.

я думаю, многие согласятся, можно выбрать несколько вариантов времени

> Engineers like to release updates a lot less frequently than tech writers

Это разговор из серии «ой, ну не все же ещё перешли на системы контроля версий».

Сегодняшние практики программирования позволяют релизиться несколько раз в день и квартальные релизы означают очень древний процесс.

> you usually push it through a QA process

просто не читай это. эта статья про очень старые реалии

👍👍

На хабре недавно была статья, почему в яндексе отказались от недельных релизов. А вы про каждый день ))

а стикеры будут?)

не читал эту статью, но такая формулировка мягко говоря некорректна.

В яндексе огромное количество команд и в большинстве канареечные деплои, т.е. само понятие «релиз» очень размазано.

В любом случае, это всё не имеет никакого отношения к документации.

Аргумент вида «девелоперы релизятся раз в квартал, а мы пишем  ежедневно, поэтому гит нам не годится» — это настолько нелепо и глупо, что даже обсуждать непонятно что.

Мы (Plesk) доки релизим сейчас от 1 до 10 раз в день.

релизноты в разных продуктах, статьи новые, опечатки исправили, переводы обновились

Я за, по этой теме или другой? Нужен какой-то gotomeeting нам наверно да?

а чего стоит возможность, например, прикрутить грамматическую проверялку и показать техписателям, как их грамотность  меняется во времени за последние 2-3 года?

Легко делается с современным инструментарием и никак не делается вордом.

Мне кажется, Zoom проплаченный подойдет. Но я поисследую ещё.

skype (с видео)/discord для связи лекторов + obs для настройки картинки (+запись трансляции) + youtube/twitch для трансляции