Sphinx vs mkdocs vs (your favorite Pythonic Doc Tool)

TL;DR – Please give opinions on Pythonic doc tools and deployment experiences

Hello,

I’m more of a technical person who has been tasked with building out the doc side of things.

I am developing a documentation portal for a scientific project written in python. The idea is to have supporting documentation (how-tos, tutorials, references, examples – basically the Divio philosophy) in a structured form.

I’ve used Sphinx before and someone recently told me about mkDocs. I’m pretty technical so have deployed Wikis on Github and have used Jekyll previously.

I checked out mkdocs and it looks pretty solid. The question is how are people deploying the portal? Via Github? A company server? An AWS instance? I’m entirely comfortable installing and setting up web servers (well Apache and NGINX) so that’s an option

I’m looking for impressions on mkdocs (or any other pyhton-ic doc tool) as well as how it is being served. Someone mentioned Jupyterbook but it looks like that project is now in maintenance mode.

Thanks