Comments (10)
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.
- Creating source RST files. Usually, they are tutorials, examples, and user guides.
- 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.
- 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.
Related Issues (20)
- No randomness for threading=True HOT 1
- Pretrained weights incompatibility for resnet10 HOT 2
- Incorrect repo name during bundle download
- Auto-select bundle version based on the version of MONAI HOT 2
- Option to Disable `Compose` list/tuple Expansion HOT 1
- Failed building wheel in python 3.11
- Metatensor can modify values? HOT 4
- Module 'SABlock' has no attribute 'causal_mask' HOT 1
- RuntimeError: Can't redefine method: forward on class in test_unetr
- New issue introduced in mypy 1.11.0
- Consideration of Flash Attention in Generative Components HOT 6
- norm_eps defined in class SPADEResBlock init is not used
- Incompatible types in assignment issue
- Unconditional MAISI sampler HOT 1
- RandomWeightedCrop doesn't randomly generate crops for a weightmap of integers HOT 1
- Anchors are not centered on grid cells
- Increased GPU memory for SurfaceDistanceMetric calculation HOT 1
- Scipy Deprecation Warnings HOT 1
- Add label smoothing param in DiceCELoss
- return erro when import ResNetFeatures HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from monai.