fix: trigger doc build all condition

.ci/pipeline/docs.yml

@@ -17,8 +17,7 @@
 trigger:
   branches:
     include:
-    - main
-    - rls/*
+    - "*"
   paths:
     include:
     - requirements-doc.txt
@@ -54,7 +53,7 @@ jobs:
     inputs:
       versionSpec: '3.11'
       addToPath: true
-  - script: sudo apt-get update && sudo apt-get install -y clang-format
+  - script: sudo apt-get update && sudo apt-get install -y clang-format pandoc 
     displayName: 'apt-get'
   - script: |
       pip install daal-devel impi-devel
@@ -64,18 +63,25 @@ jobs:
       pip list
     displayName: 'Install requirements'
   - script: |
-      export PREFIX=$(dirname $(dirname $(which python)))
-      export DALROOT=$PREFIX
+      export DALROOT=$(dirname $(dirname $(which python)))
+      export LD_LIBRARY_PATH=$(dirname $(dirname $(which python)))/lib:$LD_LIBRARY_PATH
       ./conda-recipe/build.sh
     displayName: 'Build daal4py/sklearnex'
   - script: |
       export LD_LIBRARY_PATH=$(dirname $(dirname $(which python)))/lib:$LD_LIBRARY_PATH
       cd doc/daal4py
-      make html
+      make html 2>&1 | tee build.log
+      cat build.log
+      # check for autodoc warnings
+      if grep -i "autodoc" build.log; then
+        echo "Autodoc Warnings detected, build failed!"
+        exit 1
+      fi
     displayName: 'Build daal4py documentation'
   - script: |
+      export LD_LIBRARY_PATH=$(dirname $(dirname $(which python)))/lib:$LD_LIBRARY_PATH
       cd doc
-      make html
+      ./build-doc.sh
     displayName: 'Build scikit-learn-intelex documentation'
   - script: |
       mkdir $(Build.ArtifactStagingDirectory)/html/daal4py

.gitignore

@@ -12,6 +12,8 @@ daal4py.egg-info
 doc/_build
 doc/sources/samples/*.ipynb
 doc/daal4py/_build/
+doc/build.log
+doc/daal4py/build.log
 *.obj
 *.pyd
 build_oneapi_backend

doc/build-doc.sh

@@ -14,7 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #===============================================================================
-
 SAMPLES_DIR=sources/samples
 
 # remove the samples folder if it exists
@@ -25,8 +24,9 @@ mkdir $SAMPLES_DIR
 
 # copy jupyter notebooks
 cd ..
-rsync -a --exclude='doc/$SAMPLES_DIR/daal4py_data_science.ipynb' examples/notebooks/*.ipynb doc/$SAMPLES_DIR
+rsync -a --exclude='daal4py_data_science.ipynb' examples/notebooks/*.ipynb doc/$SAMPLES_DIR
 
 # build the documentation
 cd doc
-make html
+export O="-W"
+make html

doc/daal4py/Makefile

@@ -33,4 +33,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

doc/daal4py/conf.py

@@ -29,10 +29,10 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-import os
-import sys
+# import os
+# import sys
 
-sys.path.insert(0, os.path.abspath("../.."))
+# sys.path.insert(0, os.path.abspath("../.."))
 
 
 # -- Project information -----------------------------------------------------

doc/sources/conf.py

@@ -29,10 +29,10 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-import os
+# import os
 import sys
 
-sys.path.insert(0, os.path.abspath("../"))
+# sys.path.insert(0, os.path.abspath("../"))
 
 
 # -- Project information -----------------------------------------------------