Hacker News new | ask | show | jobs
by truebosko 2861 days ago
Very interesting! I've been debating if we want to continue using Sphinx (http://www.sphinx-doc.org/en/master/usage/restructuredtext/b...) for our documentation website, and focus on a tool that provides a more robust platform for publishing a content focused site.

Sphinx is great for building out an API reference, but there's so much more to a documentation website beyond that.

Anyone have insight into this idea?

1 comments

Ghost is not the best bet for documentations. It's great in its area but not for sphinx like documentation. Better look at mkdocs! If you want to see a website we created from a Sphinx to mkdocs switch: https://news.ycombinator.com/item?id=17717513