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

Add unified docs-ci

.github/workflows/ci.yml

@@ -41,8 +41,12 @@ jobs:
           done
         shell: bash
 
-  base-images:
+  docs:
     needs: lint
+    uses: "./.github/workflows/docs-ci.yml"
+
+  base-images:
+    needs: docs
     runs-on: ubuntu-latest
     outputs:
       image_variants: "${{ steps.image_variants.outputs.image_variants }}"

.github/workflows/docs-ci.yml

@@ -0,0 +1,20 @@
+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