setup a documentation website auto-generated from code docstrings about monai HOT 10 CLOSED

from monai.

I forked this repo and created the document of MONAI API here. It was built by Sphinix, and github.io automatically pulls master branch /docs folder into repository's github pages. I tried to avoid pollute this repo, so once that page looks OK, I will create a PR.

There are at least three sub-tasks in this tasks.

1. Creating source RST files. Usually, they are tutorials, examples, and user guides.
2. Running sphinx's document build process to generate API document from docstring, and build html files from the combination of API document and RST files.
3. Publishing the html files to some document website (github.io, currently).

For current stage, we are doing most of them manually. In the future, we would like to automate them as part of CD.

from monai.

@IsaacYangSLA maybe it is possible to use pytorch CPU only to build the docs which takes < 100mb

from monai.

Copying in the initial email for complete issue history; hope that's ok.
Hi Ben,
This item was assigned to you and me. If you don’t mind, I can start and put together a proposal based on what we did before.

Let me know if this is okay with you.

Thanks,
Yan

from monai.

I don't have experience with python doc generation; do you have some go to tools for it?

from monai.

If I could put my 2 cents to this issue. In PyTorch, Torchvision (and Ignite) they are using Sphinx for docs generation. For example, for torchvision:

• https://github.com/pytorch/vision/tree/master/docs
• Makefile can be left as is (replacing the project name) and conf.py should be adapted to your project.
• main page is https://github.com/pytorch/vision/blob/master/docs/source/index.rst
• make html builds the documentation

Documentation pages are written in reStructured Text formats. Docstrings are as mentioned in the first message are in Google style.

HTH

from monai.

from monai.

Isaac to investigate Readthedocs service.

from monai.

ReadTheDocs limits memory to 1GB. However, pytorch package is around 800MB, which exceeds the memory size. With some mocked packages, I managed to build all pages and pushed them to https://monai-readthedocstest.readthedocs.io/en/latest/. The process required manually creating mocked packages/classes/functions, and did not scale well. Please take a look at https://gitlab.com/project-monai/readthedocstest/-/tree/master for those mocked codes.

from monai.

fixed via #68.

from monai.