Markdown хорош для простой документации, а Sphinx — для крупных проектов. У Sphinx больше интерфейсных инструментов, кросс-ссылки, расширения. При этом сложнее синтаксис и выше порог входа. Если нужно быстрое описание — хватит Markdown, если строить техдок как систему — лучше Sphinx
Насчет воды вы правы. Жаль, что у вас так настроен процесс документирования. Мне в работе как раз не нужно воды. Нужно кратко, по делу и с пользой для читателя
Markdown хорош для простой документации, а Sphinx — для крупных проектов. У Sphinx больше интерфейсных инструментов, кросс-ссылки, расширения. При этом сложнее синтаксис и выше порог входа. Если нужно быстрое описание — хватит Markdown, если строить техдок как систему — лучше Sphinx
Насчет воды вы правы. Жаль, что у вас так настроен процесс документирования. Мне в работе как раз не нужно воды. Нужно кратко, по делу и с пользой для читателя
Спасибо! Буду знать. Я на винде работаю и живу