[FSTORE-1426] add requirements.txt for documentation instead of using a profile in hsfs

Author: SirOibaf

.github/workflows/mkdocs-main.yml

@@ -21,7 +21,7 @@ jobs:
 
       - name: install deps
         working-directory: ./python
-        run: cp ../README.md . && pip3 install 'hsfs[python] @ git+https://github.com/logicalclocks/feature-store-api@master#subdirectory=python' && pip3 install -e .[dev,docs]
+        run: cp ../README.md . && pip3 install -r ../requirements-docs.txt && pip3 install -e .[dev]
 
       - name: generate autodoc
         run: python3 auto_doc.py

.github/workflows/mkdocs-release.yml

@@ -2,7 +2,7 @@ name: mkdocs-release
 
 on:
   push:
-    branches: [branch-*]
+    branches: [branch-*\.*]
 
 jobs:
   publish-release:
@@ -26,7 +26,7 @@ jobs:
 
       - name: install deps
         working-directory: ./python
-        run: cp ../README.md . && pip3 install -e .[dev,docs]
+        run: cp ../README.md . && pip3 install -r ../requirements-docs.txt && pip3 install -e .[dev]
 
       - name: generate autodoc
         run: python3 auto_doc.py

python/pyproject.toml

@@ -35,18 +35,6 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [ "ruff", "pytest"]
-docs = [
-    "mkdocs==1.5.3",
-    "mkdocs-material==9.5.17",
-    "mike==2.0.0",
-    "sphinx==7.2.6",
-    "keras_autodoc @ git+https://git@github.com/logicalclocks/keras-autodoc",
-    "markdown-include==0.8.1",
-    "markdown==3.6",
-    "pymdown-extensions==10.7.1",
-    "mkdocs-macros-plugin==1.0.4",
-    "mkdocs-minify-plugin>=0.2.0",
-]
 
 [build-system]
 requires = ["setuptools", "wheel"]

requirements-docs.txt

@@ -0,0 +1,11 @@
+mkdocs==1.5.3
+mkdocs-material==9.5.17
+mike==2.0.0
+sphinx==7.2.6
+keras_autodoc @ git+https://git@github.com/logicalclocks/keras-autodoc
+markdown-include==0.8.1
+mkdocs-jupyter==0.24.3
+markdown==3.6
+pymdown-extensions==10.7.1
+mkdocs-macros-plugin==1.0.4
+mkdocs-minify-plugin>=0.2.0