Телеграмм чат группы docsascode страница 977

Size: a a a

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

929 membersпожаловаться на группу

2021 November 19

Konstantin Chukhlomi... in DocOps-сообщество

А есть где-то в открытом доступе код до и после? Хотелось бы посмотреть

источник

04:01пожаловаться #1

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество

лично у меня сейчас даже в закрытом нет, с июня там не работаю :)

а так: шаблонизация элементарна как 3 копейки, вычитал шаблон, сгенерировал хэшмапу c с данными к нему, свернул - и вот выхлоп :)

источник

04:18пожаловаться #2

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество

можем на конкретных примерах рассмотреть, но лучше в привате и уже завтра

источник

04:19пожаловаться #3

Maksim Lapshin in DocOps-сообщество

разница есть конечно.

Только вопрос не совсем и не столько про скачивание туда-сюда, а про суммарную кумулятивную скорость CI.

Если сборка занимает больше 2-3 минут, теряется интерактивность.

Если прогон CI занимает более четверти часа, то это просто фиаско.

источник

06:40пожаловаться #4

Ivan Cheban in DocOps-сообщество

Я тестировал разные генераторы, но самый быстрый это Hugo, который на Go

источник

09:41пожаловаться #5

Ivan Cheban in DocOps-сообщество

Константин, спасибо за новый генератор! А можно на нем генерировать не блог, а сайт с документацией?

источник

09:43пожаловаться #6

Ramil G in DocOps-сообщество

Спасибо! Интересно было изучить.

источник

10:05пожаловаться #7

Vadim Smelyanskiy in DocOps-сообщество

Если даже базовый контейнер с Java весит сотни мегабайт, у Докера всё ещё слои в файловой системе, и слой с изменением .jar весить будет совсем чуть-чуть

источник

14:04пожаловаться #8

Konstantin Chukhlomi... in DocOps-сообщество

В принципе, ничего не мешает генерировать и сайт с документацией. У genblog нюанс в том что он сортирует все посты по дате публикации. Для документации я бы взял mkdocs https://www.mkdocs.org (Python) + https://squidfunk.github.io/mkdocs-material/
там и поиск, и разные полезные расширения типа Admonitions, Abbreviations, mermaid, …

www.mkdocs.org

Project documentation with Markdown.

источник

16:50пожаловаться #9

Ivan Cheban in DocOps-сообщество

Есть несколько генераторов для документации. Самый простой Docusaurus. Мой самый любимый на Hugo тема Docsy.

источник

17:41пожаловаться #10

2021 November 21

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

Такой вопрос. Есть большой и несколько запутанный проект на Sphinx. Появилось желание построить карту статей и взаимных ссылок. Есть ли готовые инструменты для этого?

источник

18:22пожаловаться #11

Nick Volynkin in DocOps-сообщество

Можно получить список ссылок внутри и вне документации. Для этого собери доки с таргетом linkcheck. Если дефолтный Makefile используется, то make linkcheck.

источник

20:06пожаловаться #12

Nick Volynkin in DocOps-сообщество

Но вообще, надо сделать такую штуку )

источник

20:12пожаловаться #13

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

Благодарю. linkcheck оказался очень полезен.

Тоже склоняюсь к тому, что можно и написать самому)

источник

20:45пожаловаться #14

Nick Volynkin in DocOps-сообщество

там в общем-то нужно распарсить вывод linkcheck и как-то визуализировать полученный граф