А наглядное представление должно быть всегда актуально. Или код должен быть всегда актуален наглядному представлению

Кто-то использует logseq? Я сегодня активно изучал, попробовал. В целом удобно, похоже на obsidian. Непонятно предназначение.

Всем добрый день! Вопрос про Sphinx - почему при генерации в latex-pdf между разделами могут получаться лишние пустые страницы? Причем только в некоторых разделах, когда форматирование у всех документов одинаковое, и лишних переносов строк нигде не стоит

Скорее всего, у вас документ собирается в "книжном" виде. Попробуйте в .tex файле в директиву \documentclass добавить параметр oneside:
\documentclass[letterpaper,10pt,russian,oneside]

Спасибо!

Утро доброе!

Наша команда хочет завести документацию по проекту по Docs as Code практике.

Ожидается:

Технический писатель пишет доку.
Пушит ее в гит.
Какая-то тузла подхватывает коммит с докой и публикует ее на read-only фронте, который доступен для чтения остальной командой. Наподобии swagger для API.

Можете подсказать опенсорсные тулзы для этого? Или этот подход изначально порочен и лучше доку вести в wiki формате в каком нить outline-wiki?

Концепция генерации статического файла из исходников называется static site generator, SSG. Нужно выбрать удобный формат документов — markdown, MDX, RST и из них выбирать поддерживающие генераторы

Принципиальной разницы для меня нет. markdown более популярен, RST приятно читать.

Можете посоветовать для этих 2-х форматов несколько наиболее популярных тулзов?

RST - Sphinx

Hugo, sphinx, Jekyll

Кажется где-то был удобный каталог генераторов с фильтрами, но не смог быстро найти :(

Большое вам спасибо, есть что изучать)

Посмотрите antora. Законченное решение для вашей задачи

Всем привет. Хочу настроить сфинкс, сделать, чтобы был доступ сразу к нескольким версиям документации, с переключением между ними. Пока только видел живые примеры а статей как это сделать не попадалось. Может кто-то встречал?

Вау! Это что за инструмент/расширение?

IntelliJ IDEA

А для rst там есть такая фича?

где там?