Merge pull request #97 from pedro-psb/add-new-docs-ci

Add unified docs-ci

.github/workflows/ci.yml

@@ -32,10 +32,15 @@ jobs:
           pip install requests
           sh .github/workflows/scripts/check_commit.sh
 
+  docs:
+    uses: "./.github/workflows/docs-ci.yml"
+
   pulp:
     runs-on: ubuntu-latest
-    # run only after lint finishes
-    needs: lint
+    # run only after lint and docs finishes
+    needs:
+      - lint
+      - docs
     strategy:
       fail-fast: false
       matrix:

.github/workflows/docs-ci.yml

@@ -0,0 +1,19 @@
+name: "Docs CI"
+
+on:
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: "ubuntu-20.04"
+    steps:
+      - uses: "actions/checkout@v4"
+      - name: "Set up Python"
+        uses: "actions/setup-python@v5"
+        with:
+          python-version: "3.11"
+      - name: "Install Test Dependencies"
+        run: |
+          pip install -r doc_requirements.txt
+      - name: Build docs
+        run: make docs

Makefile

@@ -0,0 +1,10 @@
+help: ## Show this help.
+	@sed -ne '/@sed/!s/## //p' $(MAKEFILE_LIST)
+
+docs: ## Build unified docs.
+	pulp-docs build
+
+servedocs: ## Serves unified docs.
+	pulp-docs serve
+
+.PHONY: docs servedocs help

doc_requirements.txt

@@ -0,0 +1 @@
+pulp-docs @ git+https://github.com/pulp/pulp-docs@main