Size: a a a

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

2019 August 28

NV

Nick Volynkin in DocOps-сообщество
ой, точно, извини )
источник

L

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

NV

Nick Volynkin in DocOps-сообщество
@kvaleev Костя, а когда будут видео с митапа?
источник

RG

Ramil G in DocOps-сообщество
Nick Volynkin
Раз уж смотрите на AsciiDoc, посмотрите ещё и на Sphinx & reStructuredText. Я тут как раз вдохновился докладом @Lananovikova про то, как из Sphinx пушить доки в Confluence и тестирую это у себя.
А чем редактировать?
источник

K

Konstantin in DocOps-сообщество
Nick Volynkin
@kvaleev Костя, а когда будут видео с митапа?
Оно по той же ссылке, что и была трансляция: https://www.youtube.com/watch?v=5N3zyvXB6Jg
источник

DC

Dmitry Chk in DocOps-сообщество
ID:
​​Introducing Markdown and Pandoc.
В этом месяце вышла новая книга про документацию как код: «Introducing Markdown and Pandoc: Using Markup Language and Document Converter», автор Thomas Mailund.

Если что, Markdown — это самый популярный (хотя не самый мощный) формат разметки, а Pandoc — универсальный конвертер между десятками форматов документов.

Книга начинает с основ Markdown и доходит до использования шаблонов и фильтров (препроцессоров) в Pandoc. Меня особенно порадовала глава про фильтры с примерами кода на Python и panflute. Когда-то я пытался писать фильтры для Pandoc, но не осилил, пришлось обрабатывать уже готовый HTML. Теперь сделаю ещё одну попытку.

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

НН

Нац Нац in DocOps-сообщество
Dmitry Chk
Кстати, в сети уже появилась пиратская версия
Да, в соседнем чате валяется
источник

SR

Stas Rychkov in DocOps-сообщество
Нац Нац
Да, в соседнем чате валяется
Хде? 🙄
источник

НН

Нац Нац in DocOps-сообщество
Stas Rychkov
Хде? 🙄
источник

NV

Nick Volynkin in DocOps-сообщество
Ты сейчас спровоцировал набег русскоязычных техписателей в украиноязычный чат. )))
источник

НН

Нац Нац in DocOps-сообщество
Ну ничо, адаптируются или ливнут :D
источник

SR

Stas Rychkov in DocOps-сообщество
Нац Нац
Ну ничо, адаптируются или ливнут :D
Nic się nie stanie... Спасибо за ссылку. 🙂
источник
2019 August 29

NV

Nick Volynkin in DocOps-сообщество
Вышел на кухню (в офисе) за чаем, а там гости из одной компании, которая делает хорошие API и доки к ним. Договорился предварительно про выступление на митапе :)
источник

NK

ID:0 in DocOps-сообщество
Митап про документацию в Новосибирске.

Прямо в эту субботу сообщество Konveerum проводит митап про документацию. Место — Новосибирск, Академгородок. Трансляция будет, если вам не слабо начать смотреть её в семь утра по МСК. :)

Сообщество Konveerum — про приборостроение, так что и митап будет с акцентом на ГОСТ, госзаказчиков, и любимые ими форматы DOCX и PDF.

В программе три доклада:

— Алёна Чернышева из Uniscan Research расскажет про то, как компания переехала с MS Word на Atlassian Confluence, но всё равно продолжила использовать Word, и почему всё именно так. Вероятно, доклад будет расширением или продолжением статьи на Хабре.

— Илья Улеско из documentat.io расскажет про переезд c DOCX на reStructuredText. В этом случае получилось переехать полностью, так что теперь уже из исходников в reST генерируется HTML, PDF и DOCX. По словам Ильи, документ в 150 страниц собирается примерно за 20 секунд.

— Дмитрий Перепелин из Моспротекста расскажет про использование DITA XML для разработки конструкторской документации. Дмитрий сообщает, что наиболее востребован формат PDF, но ещё из DITA можно делать (X)HTML, DOCX и EPUB.

Регистрация тут: https://konveerum.ru/
источник

NV

Nick Volynkin in DocOps-сообщество
@nmpotashnikoff @kvaleev тут близкая вам тема. Если не проснётесь рано в субботу, накидайте мне вопросов, я их задам от вашего имени.
источник

AY

Andrei Yemelianov in DocOps-сообщество
Nick Volynkin
@nmpotashnikoff @kvaleev тут близкая вам тема. Если не проснётесь рано в субботу, накидайте мне вопросов, я их задам от вашего имени.
Я буду в дороге, но постараюсь накидать
источник

NV

Nick Volynkin in DocOps-сообщество
Andrei Yemelianov
Я буду в дороге, но постараюсь накидать
А ты заранее накидай, темы-то известны, а по первому докладу есть статья.
источник

NV

Nick Volynkin in DocOps-сообщество
А по второму можно @ulesko заранее поспрашивать )
источник

FM

Fox Mulder in DocOps-сообщество
Темы очень интересные.  Но по опыту, из Диты очень хорошо получается html, pdf (без таблиц - с таблицами надо заниматься жестким с..) и просто никакой docx.
Хорошо бы кто-то снял, чтобы посмотреть
источник

NV

Nick Volynkin in DocOps-сообщество
Fox Mulder
Темы очень интересные.  Но по опыту, из Диты очень хорошо получается html, pdf (без таблиц - с таблицами надо заниматься жестким с..) и просто никакой docx.
Хорошо бы кто-то снял, чтобы посмотреть
Будет трансляция (правда, на ВК) и потом записи на Ютубе
источник