ci: build app's docs with RTFD (#19147)

Borda · web-flow · commit e769e233aae8 · 2023-12-13T07:37:36.000+01:00
* ci: build app's docs with RTFD
* set -ex
* .[app]
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -42,7 +42,8 @@ build:
     - pip install -U pip awscli py-tree --user
     - python -m awscli s3 sync --no-sign-request s3://sphinx-packages/ dist/ ; ls -lh dist/
     - >
-      pip install -e . -q -r _notebooks/.actions/requires.txt \
+      pip install -e ".[app]" -q -r _notebooks/.actions/requires.txt \
+          -r requirements/app/docs.txt \
           -r requirements/fabric/docs.txt \
           -r requirements/pytorch/docs.txt \
           -f 'https://download.pytorch.org/whl/cpu/torch_stable.html' -f dist/ ;
diff --git a/docs/crossroad.html b/docs/crossroad.html
@@ -9,6 +9,7 @@
     </style>
   </head>
   <body>
+    <a href="app/"><button>App</button></a>
     <a href="fabric/"><button>Fabric</button></a>
     <a href="pytorch/"><button>PyTorch</button></a>
   </body>
diff --git a/docs/rtfd-build.sh b/docs/rtfd-build.sh
@@ -1,19 +1,17 @@
 # building for PRs and skip stable and latest states
+set -ex
 
 if ! [ $READTHEDOCS_VERSION == "latest" -o $READTHEDOCS_VERSION == "stable" ];
 then
     export FAST_DOCS_DEV=1 ;
     root=$(pwd) ;
-    # build Fabric
-    cd $root/docs/source-fabric ;
-    make html --jobs $(nproc) ;
-    cd $root/docs ;
-    mv build/html build/fabric ;
-    # build PyTorch
-    cd $root/docs/source-pytorch ;
-    make html --jobs $(nproc) ;
-    cd $root/docs ;
-    mv build/html build/pytorch ;
+    for pkg in 'app' 'fabric' 'pytorch' ;
+    do
+      cd $root/docs/source-$pkg ;
+      make html --jobs $(nproc) ;
+      cd $root/docs ;
+      mv build/html build/$pkg ;
+    done ;
     # cross-road
     rm -rf build/doctrees ;
     cp crossroad.html build/index.html
