ci: Divide checkers to docs and samples

- One workflow will check documentation and the other one samples.

Signed-off-by: Arkadiusz Balys <arkadiusz.balys@nordicsemi.no>

Author: ArekBalysNordic

.github/workflows/doc-validation.yml

@@ -0,0 +1,64 @@
+name: Matter Documentation Validation
+
+on:
+  pull_request:
+    branches:
+      - main
+      - 'v*-branch'
+
+    paths:
+      - 'docs/**'
+      - 'samples/**/*.rst'
+      - 'scripts/matter_sample_checker/**'
+      - '.github/workflows/doc-validation.yml'
+      - 'west.yml'
+
+permissions:
+  contents: read
+
+env:
+  WEST_PATH_CACHE: ${{ github.workspace }}/west-path-cache
+
+jobs:
+  matter-doc-validation:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout the code
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          path: ncs-matter
+
+      - name: Set up Python
+        uses: actions/setup-python@42375524e23c412d93fb67b49958b491fce71c38 # v5
+        with:
+          python-version: 3.12
+          cache: pip
+          cache-dependency-path: |
+            ncs-matter/scripts/requirements.txt
+            ncs-matter/docs/requirements-doc.txt
+
+      - name: Install packages
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y wget python3-pip git
+          pip install -r ncs-matter/scripts/requirements.txt
+          pip install -r ncs-matter/docs/requirements-doc.txt
+
+      - name: Restore west module path cache
+        uses: actions/cache@d4323d4df104b026a6aa633fdb11d772146be0bf # v4
+        with:
+          path: west-path-cache
+          key: west-path-cache-${{ hashFiles('ncs-matter/west.yml') }}
+          restore-keys: |
+            west-path-cache-
+
+      - name: Prepare west workspace
+        run: |
+          rm -rf .west
+          west init -l ncs-matter --mf west.yml
+          west update -n -o=--depth=1 --path-cache "${WEST_PATH_CACHE}"
+
+      - name: Validate Matter documentation
+        run: |
+          python ncs-matter/scripts/matter_sample_checker/matter_doc_checker.py \
+            --base ncs-matter

.github/workflows/sample-validation.yml

@@ -56,7 +56,7 @@ jobs:
           west init -l ncs-matter --mf west.yml
           west update -n -o=--depth=1 --path-cache "${WEST_PATH_CACHE}"
 
-      - name: validate Matter samples and documentation
+      - name: Validate Matter samples
         run: |
           python ncs-matter/scripts/matter_sample_checker/matter_sample_checker.py \
             --samples-zap-yaml ncs-matter/scripts/zap_samples.yml \

docs/checks/conf.py

@@ -67,7 +67,27 @@
     "https://google.com:443",
 ]
 
-linkcheck_anchors_ignore = [r"page="]
+# Keep Sphinx default ^! for Kconfig hashbang anchors (#!CONFIG_*), plus page=.
+linkcheck_anchors_ignore = [r"^!", r"page="]
+
+# docs.nordicsemi.com redirects to nrfconnectdocs.nordicsemi.com and many section
+# anchors are rendered client-side, so verify the page responds but not anchors.
+linkcheck_allowed_redirects = {
+    r"https://docs\.nordicsemi\.com/.*": r"https://nrfconnectdocs\.nordicsemi\.com/.*",
+}
+linkcheck_anchors_ignore_for_url = (
+    r"https://docs\.nordicsemi\.com/.*",
+    r"https://nrfconnectdocs\.nordicsemi\.com/.*",
+)
+
+# Sphinx defaults to a Firefox/Sphinx User-Agent. Some sites return HTTP 403 to
+# that client while serving browsers normally. check_doc_links.py re-tests 403
+# failures with a browser-like GET before reporting them as broken.
+user_agent = (
+    "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 "
+    "(KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+)
+
 linkcheck_timeout = 30
 linkcheck_retries = 2
 linkcheck_workers = 5