НН
не очень удобно поддерживать
Можно микроскриптик который их мержит сделать, переиспользуемая документация
Size: a a a
2019 June 26
НН
AR
Можно микроскриптик который их мержит сделать, переиспользуемая документация
может быть и такой подход)
P
Можно микроскриптик который их мержит сделать, переиспользуемая документация
pandoc может собирать html страницу из нескольких файлов, md например
https://stackoverflow.com/a/5529508
https://stackoverflow.com/a/5529508
K
Немного попиарюсь на теме: https://foliant-docs.github.io/docs/preprocessors/includes/
P
кстати, вот читаю чат и редко кто обсуждает, какие вообще утилиты используют для документации у себя на проекте
NV
кстати, вот читаю чат и редко кто обсуждает, какие вообще утилиты используют для документации у себя на проекте
В Plesk внутренняя проектная документация в Confluence, тестовая в том числе в Testrail. Внешнюю документацию пишем в reST и Markdown, собираем с помощью Sphinx и Jekyll, соответственно. Поиск самописный на базе PostgreSQL. База знаний поддержки ещё есть на Zendesk Guide.
KC
В Plesk внутренняя проектная документация в Confluence, тестовая в том числе в Testrail. Внешнюю документацию пишем в reST и Markdown, собираем с помощью Sphinx и Jekyll, соответственно. Поиск самописный на базе PostgreSQL. База знаний поддержки ещё есть на Zendesk Guide.
Кайф 👌🏽 У меня анологично, только собираем при помощи https://docsify.js.org/#/ Но сейчас планируем переехать на https://docusaurus.io/en/
NV
Кайф 👌🏽 У меня анологично, только собираем при помощи https://docsify.js.org/#/ Но сейчас планируем переехать на https://docusaurus.io/en/
А расскажите, почему переезжаете, чем старый хуже, чем новый лучше?
НН
Там у докузауруса оч сочный роадмеп на версию 2.0
NV
Там у докузауруса оч сочный роадмеп на версию 2.0
Вот он, кстати https://github.com/facebook/Docusaurus/issues/789
NV
для тех, кому интересно
KC
А расскажите, почему переезжаете, чем старый хуже, чем новый лучше?
Вставали с колен с https://docsify.js.org/#/ . Так как надо было быстро запустить базу знаний для себя, в компании до этого вообще никакой документации не было. https://docusaurus.io/en/ — более гибкий, поддержка на реакте, подкрутим для себя функционально и красиво. Ну и сочные ропдмапы, да)
KC
Ну и https://docsify.js.org/#/ я запустила сама без поддержки фронта, ну и немного подкастомила. Сейчас займутся ux и фронты поплотнее
АК
Коллеги, вижу активность.... ))
Позвольте под шумок спросить: у меня сейчас vscode упорно не желает рендерить в превью встроенные в asciidoc plantuml.
Там один норм. плагин для превью аскидока и он этого делать у...порно не хочет.
Есть у кого решение?..
Уже что только не перепробовал...
Позвольте под шумок спросить: у меня сейчас vscode упорно не желает рендерить в превью встроенные в asciidoc plantuml.
Там один норм. плагин для превью аскидока и он этого делать у...порно не хочет.
Есть у кого решение?..
Уже что только не перепробовал...
NV
Коллеги, вижу активность.... ))
Позвольте под шумок спросить: у меня сейчас vscode упорно не желает рендерить в превью встроенные в asciidoc plantuml.
Там один норм. плагин для превью аскидока и он этого делать у...порно не хочет.
Есть у кого решение?..
Уже что только не перепробовал...
Позвольте под шумок спросить: у меня сейчас vscode упорно не желает рендерить в превью встроенные в asciidoc plantuml.
Там один норм. плагин для превью аскидока и он этого делать у...порно не хочет.
Есть у кого решение?..
Уже что только не перепробовал...
на ум приходит такое: держать plantuml в отдельных файлах *.puml, инклюдить их в asciidoc
NV
ну и в отдельных файлах превью будет работать, конечно
АК
да, я пока так и посоветовал, работать отдельно с ними, там ессно работает, т.к. plantuml-плагин отличный.
АК
Блин, для вскода нет норм плагина, чтобы отображал тулбарчик для основных команд для аскидока...
Для маркдауна, где команд раз два и обчелся, такое есть.
Грустно...
Для маркдауна, где команд раз два и обчелся, такое есть.
Грустно...