Added workflow to validate links against each PR

.github/workflows/pr-link-validation.yml

@@ -0,0 +1,30 @@
+name: "Docs: Antora Link Validation"
+
+on:
+  pull_request:
+    branches:
+      - main
+      - staging
+    paths:
+      - '**/*.adoc'
+      - 'ss-local-playbook.yml'
+      - 'Makefile'
+
+jobs:
+  validate-internal-links:
+    name: Run Antora Build & Link Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20' # Matches standard modern Antora environments
+
+      - name: Install Dependencies
+        run: make environment
+
+      - name: Verify Documentation Links
+        run: make pr-link-check

Makefile

@@ -1,5 +1,12 @@
 .PHONY: all test
 
+.PHONY: pr-link-check
+pr-link-check:
+	mkdir -p tmp
+	npx antora --version
+	npx antora --log-failure-level=warn --stacktrace --log-format=pretty --log-level=info \
+		ss-local-playbook.yml
+
 .PHONY: local
 local:
 	mkdir -p tmp

docs/latest/modules/en/pages/test.adoc

@@ -0,0 +1,3 @@
+xref:installing-suse-obs.adoc[this works]
+
+xref:installing-suse-obss.adoc[broken link]