Это первый выпуск с гостями!

В этом выпуске мы послушаем долгу и интересную историю отношений компании КУРС, а в частности Вани и Коли с документацией. Узнаем почему для документации хорош AscciDoc и чем он лучше Markdown.

С чем он интегрируется и как генерируется, а так же как его можно использовать для подготовки документации, оформленной по ГОСТ.

Guillaume Grossetie, который сейчас пилит AsciiDoctor и много чего сделал для нас, узнав, что мы будем в подкасте, просил следующее:

I think what we need to make asciidoctor-web-pdf even better is more use cases. So if you can convince a few people to give it a try and provide feedback that would be great!

Guillaume Grossetie

• https://github.com/CourseOrchestra/course-doc — шаблоны для вывода PDF по старинке, через XSL-FO, в виде, приемлемом для наших (а значит, скорей всего, и ваших) заказчиков
• https://github.com/Mogztter/asciidoctor-web-pdf — та самая штука, которая работает выводит в PDF через puppeteer через CSS-ки для печати
• Сам полифил Paged.js для спецификаций W3C Paged Media и Generated Content for Paged Media — https://www.pagedjs.org/
• Проект для генерации pdf из asciidoctor на основе полифила — https://github.com/Mogztter/asciidoctor-web-pdf
• Стили docbook-xsl (для старой цепочки генерации pdf через docbook) — https://github.com/CourseOrchestra/course-doc
• https://habr.com/ru/post/416077/ Колина статья про PlantUML
• https://habr.com/ru/post/456032/ Ванина статья про то, как он готовит слайды из AsciiDoctor