ci: refresh workflows for MkDocs migration and two-stack integration tests

build.yml — widen pre-merge coverage:
  - matrix now {ubuntu, macos, windows} × {3.9, 3.13} instead of
    ubuntu × 3.11. 3.9 and 3.13 are the bookend versions declared in
    pyproject.toml; the release workflow continues to exercise the
    full 3.9-3.13 range at tag time.
  - drops stale `wip_process` branch trigger.
  - adds `fail-fast: false` so one OS / Python failure doesn't mask
    others.

integration.yml — actually run the integration tests:
  - bumps `actions/checkout` v2 → v5 and `actions/setup-python`
    v2 → v5.
  - brings up both the ROS 1 and the new ROS 2 test stacks (default
    ports 9090 / 9091, set by their compose files).
  - sets `COMPAS_FAB_RUN_ROS_INTEGRATION_TESTS=1` so the
    `ros1_client` / `ros2_client` fixtures actually connect instead of
    silently skipping the suite — without this, CI was reporting green
    while running zero integration assertions.
  - replaces `pytest --doctest-modules` + `pytest docs` with just
    `pytest --doctest-modules`; the second invocation was a leftover
    from the Sphinx era and produces nothing useful against the new
    Markdown docs tree.
  - tears down both stacks unconditionally (`if: always()`).
  - drops stale `wip_process` branch trigger.

docs.yml — wire the action up for MkDocs:
  - bumps `compas-dev/compas-actions.docs` v3 → v5; the v5 release
    added a `generator` input so the same action can deploy MkDocs
    sites in addition to the original Sphinx flow.
  - passes `generator: mkdocs` so it picks the right code path for
    our `invoke docs` build.

pr-checks.yml — bump `actions/checkout` v1 → v5.

release.yml and publish_yak.yml are unchanged (already current).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: gonzalocasas

.github/workflows/build.yml

@@ -4,7 +4,6 @@ on:
   push:
     branches:
       - main
-      - wip_process
   pull_request:
     branches:
       - main
@@ -14,9 +13,12 @@ jobs:
     if: "!contains(github.event.pull_request.labels.*.name, 'docs-only')"
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-latest]
-        python: ['3.11']
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        # Bookend Python versions declared in `pyproject.toml` classifiers.
+        # The release workflow exercises the full 3.9-3.13 matrix at tag time.
+        python: ['3.9', '3.13']
 
     steps:
       - uses: compas-dev/compas-actions.build@v3

.github/workflows/docs.yml

@@ -15,7 +15,11 @@ jobs:
     if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'pull_request_review' && github.event.review.state == 'approved')
     runs-on: ubuntu-latest
     steps:
-      - uses: compas-dev/compas-actions.docs@v3
+      - uses: compas-dev/compas-actions.docs@v5
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           doc_url: https://compas.dev/compas_fab
+          # Site is built with MkDocs (via `invoke docs`); `v5` of the action
+          # added the `generator` switch so it can deploy MkDocs sites in
+          # addition to the original Sphinx flow.
+          generator: mkdocs

.github/workflows/integration.yml

@@ -4,37 +4,47 @@ on:
   push:
     branches:
       - main
-      - wip_process
   pull_request:
     branches:
       - main
       - LTS-main-1.x
 
 jobs:
   build:
-    name: ubuntu-py311-integration
+    name: ubuntu-py39-integration
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Set up Python 3.11
-        uses: actions/setup-python@v2
+      - uses: actions/checkout@v5
+      - name: Set up Python 3.9
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
-      - name: Set up docker containers
+          python-version: '3.9'
+
+      - name: Bring up both ROS stacks
+        # Defaults: ROS 1 rosbridge on 9090, ROS 2 rosbridge on 9091, ROS 2
+        # HTTP assets on 9092. See `tests/integration_setup/README.md`.
         run: |
-          docker compose -f "tests/integration_setup/docker-compose.yml" up -d --build
+          docker compose -f tests/integration_setup/docker-compose.yml      up -d --build
+          docker compose -f tests/integration_setup/docker-compose-ros2.yml up -d --build
           docker ps -a
+
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install wheel
-      - name: Install
-        run: |
+          python -m pip install --upgrade pip wheel
           python -m pip install --no-cache-dir -r requirements-dev.txt
-      - name: Run integration tests
+
+      - name: Run tests + doctests
+        # `COMPAS_FAB_RUN_ROS_INTEGRATION_TESTS=1` opts the `ros1_client` /
+        # `ros2_client` fixtures into actually connecting (otherwise every
+        # integration test is skipped). `--doctest-modules` picks up
+        # doctests embedded in `src/compas_fab/` modules.
+        env:
+          COMPAS_FAB_RUN_ROS_INTEGRATION_TESTS: "1"
         run: |
           pytest --doctest-modules
-          pytest docs
+
       - name: Tear down docker containers
+        if: always()
         run: |
-          docker compose -f "tests/integration_setup/docker-compose.yml" down
+          docker compose -f tests/integration_setup/docker-compose.yml      down
+          docker compose -f tests/integration_setup/docker-compose-ros2.yml down

.github/workflows/pr-checks.yml

@@ -11,7 +11,7 @@ jobs:
     name: Check Actions
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v5
       - name: Changelog check
         uses: Zomzog/changelog-checker@v1.1.0
         with: