Size: a a a

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

2019 February 19

DS

Dmitry Simonov in DocOps-сообщество
Fox Mulder
А это тоже техписы делают?
А кто мешает? За это готовы платить бабки.
источник

FM

Fox Mulder in DocOps-сообщество
Круто. Честно
источник
2019 February 20

ДС

Денис Старков in DocOps-сообщество
Может кто-нибудь напомнить, где-то в этом чате была ссылка на ресур, как прикрутить такие фишки в readme?
источник

NV

Nick Volynkin in DocOps-сообщество
Денис Старков
Может кто-нибудь напомнить, где-то в этом чате была ссылка на ресур, как прикрутить такие фишки в readme?
Это ж просто ссылки на картинки
источник

ДС

Денис Старков in DocOps-сообщество
не-не, это различные метрики, и кто-то в этом чате (вроде) делился ссылкой на набор этих метрик
источник

a

arvikon in DocOps-сообщество
источник

ДС

Денис Старков in DocOps-сообщество
источник

L

Lana in DocOps-сообщество
Может кто-то знает, как можно в Sphinx-RST включить в index.rst в toc файл, который лежит за пределами директории с доками.

Юз кейс такой: я хочу документацию на сервис положить рядом с кодом этого сервиса. То есть как направить сфинкс идти по абсолютному пути, а не относительному.
источник

I

Igor in DocOps-сообщество
А через ln -s не проще его обмануть?
источник

НН

Нац Нац in DocOps-сообщество
Igor
А через ln -s не проще его обмануть?
тоже подумал о таком лайфхаке глобальном
источник
2019 February 21

NV

Nick Volynkin in DocOps-сообщество
Lana
Может кто-то знает, как можно в Sphinx-RST включить в index.rst в toc файл, который лежит за пределами директории с доками.

Юз кейс такой: я хочу документацию на сервис положить рядом с кодом этого сервиса. То есть как направить сфинкс идти по абсолютному пути, а не относительному.
Задай абсолютный путь в toctree
источник

L

Lana in DocOps-сообщество
Nick Volynkin
Задай абсолютный путь в toctree
не работает так, он смотрит в относительный
источник

L

Lana in DocOps-сообщество
то есть он не выйдет из текущей директории
источник

NV

Nick Volynkin in DocOps-сообщество
Хмм, точно. include так может, а toctree нет.
источник

L

Lana in DocOps-сообщество
Nick Volynkin
Хмм, точно. include так может, а toctree нет.
а как include пустить по абсолютному пути?
источник

NV

Nick Volynkin in DocOps-сообщество
include понимает ../../.., в рамках одного репозитория этого достаточно
источник

L

Lana in DocOps-сообщество
Nick Volynkin
include понимает ../../.., в рамках одного репозитория этого достаточно
это тоже не сработало, эх. Также не сработал literalinclude
источник

L

Lana in DocOps-сообщество
Этого парня (сфинкс) нелегко провести он ищет все в spninx-doc директории
источник

NV

Nick Volynkin in DocOps-сообщество
Lana
Этого парня (сфинкс) нелегко провести он ищет все в spninx-doc директории
тоже проверил: если заинклюдить внешний документ, то пути в нём всё равно считаются относительно index.
источник

NV

Nick Volynkin in DocOps-сообщество
Тогда симлинк
источник