[CI] Remove commenting by PR check github bot.

.github/workflows/ci.yml

@@ -35,6 +35,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
             essimaging:
@@ -44,6 +45,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
             essnmx:
@@ -53,6 +55,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
             essreflectometry:
@@ -62,6 +65,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
             essdiffraction:
@@ -71,6 +75,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
             esssans:
@@ -80,6 +85,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
             essspectroscopy:
@@ -89,6 +95,7 @@ jobs:
               - 'pixi.lock'
               - 'pixi.toml'
               - '.github/workflows/ci.yml'
+              - '.github/workflows/docs.yml'
               - '.pre-commit-config.yaml'
               - '.python-version'
 
@@ -108,7 +115,7 @@ jobs:
 
   test:
     name: Test ${{ matrix.package }}
-    needs: [changes, formatting]
+    needs: [ changes, formatting ]
     if: needs.changes.outputs.packages != '[]'
     strategy:
       fail-fast: false
@@ -129,34 +136,23 @@ jobs:
 
   docs:
     name: Docs ${{ matrix.package }}
-    needs: [changes, test]
+    needs: [ changes, test ]
     if: needs.changes.outputs.packages != '[]'
     strategy:
       fail-fast: false
       matrix:
         package: ${{ fromJSON(needs.changes.outputs.packages) }}
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-      - uses: prefix-dev/setup-pixi@v0.9.4
-        with:
-          pixi-version: v0.68.0
-          frozen: true
-          environments: docs-${{ matrix.package }}
-      - name: Build docs
-        run: pixi run docs-${{ matrix.package }}
-      - uses: actions/upload-artifact@v7
-        id: artifact-upload-step
-        with:
-          name: docs-${{ matrix.package }}
-          path: packages/${{ matrix.package }}/html
-      - run: echo "::notice::https://remote-unzip.scipp.deno.net/${{ github.repository }}/artifacts/${{ steps.artifact-upload-step.outputs.artifact-id }}"
+    permissions:
+      contents: write
+    uses: ./.github/workflows/docs.yml
+    with:
+      package: ${{ matrix.package }}
+      publish: false
+      linkcheck: false
 
   report:
     name: Report Job Status
-    needs: [changes, formatting, test, docs]
+    needs: [ changes, formatting, test, docs ]
     if: always()  # Should always run regardless of the state of the needs jobs.
     runs-on: ubuntu-24.04
     steps:

.github/workflows/docs.yml

@@ -0,0 +1,116 @@
+name: Docs
+
+on:
+  workflow_dispatch:
+    inputs:
+      package:
+        description: 'Package to build documentation for.'
+        required: true
+        type: choice
+        options:
+          - essreduce
+          - essimaging
+          - essnmx
+          - essreflectometry
+          - essdiffraction
+          - esssans
+          - essspectroscopy
+      publish:
+        description: 'Publish documentation to GitHub pages.'
+        default: false
+        type: boolean
+      branch:
+        description: 'Branch/tag with documentation source. If not set, the current branch will be used.'
+        default: ''
+        required: false
+        type: string
+      linkcheck:
+        description: 'Run the link checker.'
+        default: true
+        required: false
+        type: boolean
+  workflow_call:
+    inputs:
+      package:
+        description: 'Package to build documentation for.'
+        required: true
+        type: string
+      publish:
+        default: false
+        type: boolean
+      branch:
+        description: 'Branch/tag with documentation source. If not set, the current branch will be used.'
+        default: ''
+        required: false
+        type: string
+      linkcheck:
+        description: 'Run the link checker. If not set the link checker will not be run.'
+        default: false
+        required: false
+        type: boolean
+
+env:
+  PIXI_FROZEN: true
+  PIXI_NO_INSTALL: true
+
+jobs:
+  docs:
+    name: Build documentation
+    runs-on: 'ubuntu-24.04'
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.branch == '' && github.ref || inputs.branch }}
+          fetch-depth: 0  # history required to determine version
+      - uses: prefix-dev/setup-pixi@v0.9.4
+        with:
+          pixi-version: v0.68.0
+          frozen: true
+          environments: docs-${{ inputs.package }}
+      - name: Build docs
+        run: pixi run docs-${{ inputs.package }}
+      - name: Test docs
+        run: pixi run docs-${{ inputs.package }} doctest
+      - name: Linkcheck
+        run: pixi run docs-${{ inputs.package }} linkcheck
+        if: ${{ inputs.linkcheck }}
+      - uses: actions/upload-artifact@v7
+        id: artifact-upload-step
+        with:
+          name: docs-${{ inputs.package }}
+          path: packages/${{ inputs.package }}/html
+          if-no-files-found: error
+      - run: echo "::notice::https://remote-unzip.scipp.deno.net/${{ github.repository }}/artifacts/${{ steps.artifact-upload-step.outputs.artifact-id }}"
+
+  deploy:
+    name: Deploy documentation
+    needs: [ docs ]
+    if: ${{ inputs.publish }}
+    runs-on: 'ubuntu-24.04'
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ inputs.branch == '' && github.ref || inputs.branch }}
+      - uses: actions/download-artifact@v7
+        with:
+          name: docs-${{ inputs.package }}
+          path: docs_html
+      - name: Prepare site
+        run: |
+          PACKAGE=${{ inputs.package }}
+          SUBPATH=${PACKAGE#ess}
+          git fetch origin gh-pages:gh-pages || true
+          git worktree add gh-pages-site gh-pages || mkdir -p gh-pages-site
+          rm -rf gh-pages-site/$SUBPATH
+          mkdir -p gh-pages-site/$SUBPATH
+          cp -a docs_html/. gh-pages-site/$SUBPATH/
+          cp docs/index.html gh-pages-site/index.html
+          touch gh-pages-site/.nojekyll
+      - name: Build search index
+        run: npx pagefind@latest --site gh-pages-site --bundle-dir pagefind
+      - uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: gh-pages-site

.github/workflows/nightly.yml

@@ -27,7 +27,7 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
-          fetch-depth: 0
+          fetch-tags: true
       - uses: prefix-dev/setup-pixi@v0.9.4
         with:
           pixi-version: v0.68.0
@@ -53,11 +53,39 @@ jobs:
     steps:
       - uses: actions/checkout@v6
         with:
-          fetch-depth: 0
-      - uses: prefix-dev/setup-pixi@v0.9.4
+          fetch-tags: true
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
-          pixi-version: v0.68.0
-          frozen: true
-          environments: lb-${{ matrix.package }}
+          version: "0.7.21"
+          python-version: "3.11"
+          cache-suffix: ${{ matrix.package }}
       - name: Test with lowest direct dependencies
-        run: pixi run -e lb-${{ matrix.package }} test ${{ matrix.package }}
+        working-directory: packages/${{ matrix.package }}
+        run: uv run --extra=test --resolution=lowest-direct pytest
+
+  latest-dependencies:
+    name: Latest dependencies ${{ matrix.package }}
+    strategy:
+      fail-fast: false
+      matrix:
+        package:
+          - essreduce
+          - essimaging
+          - essnmx
+          - essdiffraction
+          - essreflectometry
+          - esssans
+          - essspectroscopy
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-tags: true
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.7.21"
+          python-version: "3.11"
+          cache-suffix: ${{ matrix.package }}
+      - name: Test with latest dependencies
+        working-directory: packages/${{ matrix.package }}
+        run: uv run --extra=test --resolution=highest pytest