Size: a a a

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

2021 June 25

VS

Vadim Smelyanskiy in DocOps-сообщество
Да, там та же логика, для решения той же проблемы

Issue tracker'ы, вроде YouTrack или JIRA так при изменении проекта у выбранной задачи оставляют связь в идентификаторах задач, что PROJ_X-12 это PROJ_Y-3
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Только мне правда плохо представляется ситуация, где это проще, чем препроцессор

А расскажите, как превьюер будете допиливать? Не помню, чтобы родной BitBucket'овский можно было расширять
источник

RT

Roman Tsirulnikov in DocOps-сообщество
идея хорошая, ушел завершать день и осознавать
сообщество часто подкидывает идеи, о которых сам не всегда подумаешь)
источник

RT

Roman Tsirulnikov in DocOps-сообщество
родной в BB скорее не работает, чем работает

мы приделали вызов ascidoctor.js при просмотре документа
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Прикольно
А может тогда и складывать куда-нибудь JSON с индексом ссылок, выведенных препроцессором можно?

Что-то вроде того, как на стороне клиента поиск реализуется через Lunr.js
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Хорошо, что по докопс сообщество собралось вообще)

Спасибо, @Nick_Volynkin !
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Ещё вариант с препроцессором, возможно тоже поможет https://docs.antora.org/antora/2.2/page/page-id/
источник
2021 June 26

NP

Nikolaj Potashnikov in DocOps-сообщество
Слово "программирование" звучит как-то страшновато. Но это в худшем случае несколько десятков строчек кода. Причем, в основном, шаблонизатора. Пытался это показать в статье, возможно не очень получилось. Тут скорее проблемы будут в организационной части, как организована сама разработка
источник

RG

Ramil G in DocOps-сообщество
Кстати, для работы с документацией (markdown+git) с айпада есть workingcopyapp. Бесплатная версия ничего особо не умеет, но приложение интересное
источник

СИ

Степан stillru Иллич... in DocOps-сообщество
Emacs? [sarcasm]
источник

a

akater in DocOps-сообщество
А почему сарказм?  markdown-mode и magit не в коробке, но легко установить.
источник

СИ

Степан stillru Иллич... in DocOps-сообщество
Сам пользуюсь. Но порог освоения высокий
источник

FM

Fedor Moroseev in DocOps-сообщество
Посмотрю
источник
2021 June 28

J

Jonny Cuba in DocOps-сообщество
А кто-нибудь решал задачу, как сделать ссылку со страниц Confluence, которые собираются из гит,  на файл в этом хранилище.
источник

RT

Roman Tsirulnikov in DocOps-сообщество
На страницу confluence вставляешь HTML macro такого содержания

<iframe id="result" style="width:100%;height:87vh;border:none;" scrolling="yes" src="https://bitbucket.host../pages/...project..../master/browse/index.html"></iframe>
источник

RT

Roman Tsirulnikov in DocOps-сообщество
один минус: текст не индексируется поиском confluence
источник

RT

Roman Tsirulnikov in DocOps-сообщество
поэтом под этим блоком полезно разместить скрытый expand с набором ключевых слов для поиска
источник

RT

Roman Tsirulnikov in DocOps-сообщество
спасибо
источник

J

Jonny Cuba in DocOps-сообщество
Спасибо!
источник

RT

Roman Tsirulnikov in DocOps-сообщество
появилась идея как сделать то что мне нужно.
Относительные ссылки относительно текущего документа забудем как класс.
Будем строить абсолютные ссылки, но выдглядеть они будут как относительные относительно некоего module root .
например /processes/a-process/index.adoc,  /services/someservice/index.adoc
сам module root будет выставляться средой рендеринга/сборки как переменная в asciidoctor
источник