Size: a a a

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

2019 August 22

NK

ID:0 in DocOps-сообщество
1. sphinx-version-warning: allows you to add a custom warning banner at the top of your documentation pages to communicate some important about this documentation: https://sphinx-version-warning.readthedocs.io

2. sphinx-notfound-page: is great to create a "Not found" (or 404) page to show when the reader hit a not found page: https://sphinx-notfound-page.readthedocs.io

3. sphinx-hoverxref: adds amazing tooltips on your cross-references that points to another page/section of the documentation including its content on the tooltip: https://sphinx-hoverxref.readthedocs.io

#python
источник

RG

Ramil G in DocOps-сообщество
разве writethedocs не на RST?
источник

NV

Nick Volynkin in DocOps-сообщество
Ramil G
разве writethedocs не на RST?
Это слак международного сообщества Write the Docs, там есть чаты про всё.
Наверное, вы путаете с readthedocs.org, там действительно reST
источник

RG

Ramil G in DocOps-сообщество
Nick Volynkin
Это слак международного сообщества Write the Docs, там есть чаты про всё.
Наверное, вы путаете с readthedocs.org, там действительно reST
ага. перепутал. Вступил уже в тот чат :)
источник

RG

Ramil G in DocOps-сообщество
что скажете про связку  Gatsby + AsciiDoc?
источник

НН

Нац Нац in DocOps-сообщество
Ramil G
что скажете про связку  Gatsby + AsciiDoc?
Ну, она работает :)
источник

RG

Ramil G in DocOps-сообщество
Нац Нац
Ну, она работает :)
у кого работает? там довольно сложно запуститься.
источник

НН

Нац Нац in DocOps-сообщество
Ramil G
у кого работает? там довольно сложно запуститься.
Вот у кого-то https://www.marqeta.com/docs
источник

RG

Ramil G in DocOps-сообщество
во-во. в том форуме и нашел. Похоже, единственный саксесс стори
источник

НН

Нац Нац in DocOps-сообщество
Не уверен
источник

НН

Нац Нац in DocOps-сообщество
В чем конкретно сложности?
источник

RG

Ramil G in DocOps-сообщество
Нац Нац
В чем конкретно сложности?
лично я не знаю GraphQL
источник

НН

Нац Нац in DocOps-сообщество
Ramil G
лично я не знаю GraphQL
Зачем для этого графql?
источник

RG

Ramil G in DocOps-сообщество
пишут, что по сравнению c HUGO он ооочень медленно строит сайт. Но зато потом у пользователей работает намного быстрее и комфортнее
источник

НН

Нац Нац in DocOps-сообщество
Настраивается все в пару кликов, кладешь adoc файл и все работает
источник

НН

Нац Нац in DocOps-сообщество
Наверняка где-то есть кнопка на netlify с надписью Deploy
источник

NV

Nick Volynkin in DocOps-сообщество
Ramil G
пишут, что по сравнению c HUGO он ооочень медленно строит сайт. Но зато потом у пользователей работает намного быстрее и комфортнее
Это просто Hugo слишком быстрый ))
источник

RG

Ramil G in DocOps-сообщество
погоди. может я это гоню. Тут же чатик про докОпс. Я так понимаю, про технологии вокруг документописания
источник

NV

Nick Volynkin in DocOps-сообщество
Ramil G
погоди. может я это гоню. Тут же чатик про докОпс. Я так понимаю, про технологии вокруг документописания
Да, и эти технологии довольно быстро меняются. Практически, мы открываем портал в ад (зачеркнуто) фронтенд и девопс. И оттуда на нас лезет всякое вроде GraphQL. ))
источник

RG

Ramil G in DocOps-сообщество
Nikolaj Potashnikov
Мы готовим документы по ГОСТ 34 в asciidoc и есть еще несколько человек в этом чате, которые готовят документы по ГОСТ 34. Asciidoc не имеет нормальных средств экспорта в latex, поэтому используется цепочка asciidoc - docbook - fop (with xslt) - pdf
Чем редактируете документы? как работаете с таблицами? как происходит рецензирование и контроль версий
источник