Я тут несколько месяцев назад просил посоветовать в чем можно было бы получше организовать показ документации (и чисто технической и менее технической) open-source проекта, чтобы разработчики/пользователи читали и радовались. Тогда посоветовали Sphinx, который умеет генерировать документацию прямиком из кода. Проблема была в том, что мы им и так пользовались, и наша претензия была скорее визуально-эстетического плана.
readthedocs.io прямо противно читать.
Собственно пишу сейчас потому что нашел отличную альтернативу от Evil Martians. Сфинкс и автоматика не прикручены, но если не пугает необходимость ручками сделать свой сайтик с документацией (в том числе и достаточно технической направленности), то вариант великолепный, как по мне!
- В реальности сайт с документацией выглядит вот так:
https://logux.io/ Приятно читать!
- Код сайта:
https://github.com/logux/logux.io- Рассказ как этой сайт делали:
https://evilmartians.com/chronicles/new-home-for-logux-pouring-love-into-an-oss-documentation-websiteПользуйтесь!