Add PR workflow and related facilities

[noissue]

.github/workflows/build.yml

@@ -0,0 +1,27 @@
+name: "Build"
+
+on:
+  workflow_call:
+
+jobs:
+  build:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: "actions/checkout@v4"
+      - name: "Set up Python"
+        uses: "actions/setup-python@v5"
+        with:
+          python-version: "3.11"
+      - name: "Install python dependencies"
+        run: |
+          pip install build setuptools wheel
+      - name: "Build wheels"
+        run: |
+          make build
+      - name: "Upload wheels"
+        uses: "actions/upload-artifact@v4"
+        with:
+          name: "pulp_docs_package"
+          path: |
+            dist/
+          if-no-files-found: "error"

.github/workflows/docs.yml

@@ -0,0 +1,19 @@
+name: "Docs"
+
+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

.github/workflows/pr.yml

@@ -0,0 +1,28 @@
+name: "pulp-docs CI"
+
+on:
+  pull_request:
+
+concurrency:
+  group: "main-${{ github.ref_name }}-${{ github.workflow }}"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    uses: "./.github/workflows/build.yml"
+  docs:
+    needs:
+      - "build"
+    uses: "./.github/workflows/docs.yml"
+  ready-to-ship:
+    # This is a dummy dependent task to have a single entry for the branch protection rules.
+    runs-on: "ubuntu-latest"
+    needs:
+      - "docs"
+    if: "always()"
+    steps:
+      - name: "Collect needed jobs results"
+        run: |
+          echo '${{toJson(needs)}}' | jq -r 'to_entries[]|select(.value.result!="success")|.key + ": " + .value.result'
+          echo '${{toJson(needs)}}' | jq -e 'to_entries|map(select(.value.result!="success"))|length == 0'
+          echo "CI says: Looks good!"

Makefile

@@ -0,0 +1,7 @@
+build:
+	pyproject-build -n
+
+docs:
+	pulp-docs build
+
+.PHONY: build docs

doc_requirements.txt

@@ -0,0 +1 @@
+.