Не делаем( а надо бы
doxygen ?
отказываюсь от комментариев
Не пишу, но варианта два - либо Doxygen либо Sphinx
Некрасивый сайтик выходит Мусорить комментариями в коде не очень хочется, хотя удобно..
sphinx? с красивой sphinx_book_theme
Ну я думал, да Но красивого там мало Думаю docusaurus.io воспользоваться
Если найдёшь что-нибудь красивое, пингани. Или если получится что-то с https://docusaurus.io/. Я в своё время разочаровался и остался на сфинксе
Пингану Сейчас буду пытаться docusarus тыкать Скажи, норм если я в мейне буду держать исходники к документации?
Не вижу проблем. У многих проектов есть папка /docs. При этом сгенерированный сайт по документации обычно в отдельной ветке
Ну я вместе с сайтом хочу хранить в мастере
можно попробовать подкрутить https://www.doxygen.nl/manual/customize.html
Обсуждают сегодня