Size: a a a

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

2019 February 18

rd

rus dacent in DocOps-сообщество
Ещё для TeX'а есть ещё WYSIWYG под названием LyX, сам я его не люблю, но кому то нравится =)
источник

A

Antonio in DocOps-сообщество
Igor
А вы не знаете софта, которым можно делать такие вот сниппеты с футнотами нумерованными, хотя бы по строкам?
В идеале как плагин к какой-то ide
Это стандартная фича в asciidoctor
источник

I

Igor in DocOps-сообщество
О! Круто, спасибо
источник

A

Antonio in DocOps-сообщество
@shrimpsizemoose именно)
источник

NV

Nick Volynkin in DocOps-сообщество
Небось и книжка написана на Asciidoc
источник

A

Antonio in DocOps-сообщество
Nick Volynkin
Небось и книжка написана на Asciidoc
Это была моя первая мысль
источник

НН

Нац Нац in DocOps-сообщество
Antonio
Это стандартная фича в asciidoctor
Блин, круто, чет я упустил эту фичу
источник

KC

Kseniya Chudakova in DocOps-сообщество
Ребят, а подскажите-покажите классные примеры Deployment Diagrams, можно статейки и всякое, что поспособствует повышению скилла. Понимаю, практика мне поможет, но хочется найти классную теорию)
источник

М

Миша in DocOps-сообщество
Всем привет!
Не знаю было или нет - посоветуйте пожалуйста хороший инструмент для рисования блок схем и диаграмм с git историей
источник
2019 February 19

DN

Dmitry Nagovitsin in DocOps-сообщество
источник

ИЦ

Игорь Цупко in DocOps-сообщество
а вот интересный замес
источник

ИЦ

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

FM

Fox Mulder in DocOps-сообщество
Ммм интересно однако
источник

АК

Анатолий Клюса in DocOps-сообщество
Миша
Всем привет!
Не знаю было или нет - посоветуйте пожалуйста хороший инструмент для рисования блок схем и диаграмм с git историей
PLantUML
источник

NV

Nick Volynkin in DocOps-сообщество
Семинар Advanced Technical Writing.

Сейчас будет как будто реклама, но я и так раз в неделю кому-нибудь рекомендую пойти учиться документации к Семёну Факторовичу (@factorized). Теперь порекомендую всем сразу.

---

5–6 марта Семён проводит в Москве двухдневный семинар Advanced Technical Writing.

Это ёмкий практический курс о критериях качества документации, целеполагании документационных активностей и о тонкостях описания сложных технических систем.

За два полных учебных дня участники рассмотрят и обсудят теоретические аспекты выстраивания процессов документирования и выполнят множество практических заданий.

Курс будет полезен техническим писателям, системным аналитикам, и всем, кто работает с технической документацией.

---

Помните, я писал про критерии целеполагания технического документа? Вот я о них узнал на этом самом семинаре. Был на нём дважды: весной 2017 и осенью 2018 года. Программа сильно обновилась: в первый раз критериев целеполагания было четыре, а во второй раз стало пять (-1 и +2).

В общем, рекомендую сходить самим или отправить сотрудников: http://documentat.io/courses/advanced-techwriting-moscow.
источник

L

Lana in DocOps-сообщество
Я плюсую, отличный двухдневный dive, и самое ценное - много практики и фидбека прямо на лету, разбираем, критикуем, учимся, прошли какую-то технику, например, те же критерии целеполагания - тут же разобрали на практике, написали кусочек текста.
источник

L

Lana in DocOps-сообщество
Ябещепошларазик
источник

NV

Nick Volynkin in DocOps-сообщество
Если что, Семён будет на ТимЛидКонфе, можно его там будет расспросить подробнее.
источник

DS

Dmitry Simonov in DocOps-сообщество
А кто-то делал в swagger протоколы xml soap? У кого есть полноценный опыт?
источник

FM

Fox Mulder in DocOps-сообщество
Dmitry Simonov
А кто-то делал в swagger протоколы xml soap? У кого есть полноценный опыт?
А это тоже техписы делают?
источник