nbsphinx is super handy! A cool tool to combine with it is jupytext, so you can keep your notebooks as rmarkdown files, which is a bit more human readable / Git

nbsphinx is super handy! A cool tool to combine with it is jupytext, so you can keep your notebooks as rmarkdown files, which is a bit more human readable / GitHub editable. I did this with a recent library, siuba, and have not regretted it! https://github.com/machow/siuba/tree/master/docs https://github.com/machow/siuba/tree/master/docs