SWPROT-8953: github: Build docs package and deploy to web

Currently only tags are deployed to gh-pages,
ideally docs should be versionned and tagged
and eventually browsable for users.

The deploy part was not fully tested, yet.
It may be touched in later patch.

Relate-to: https://siliconlabssoftware.github.io/z-wave-protocol-controller
Origin: SiliconLabsSoftware#30
Signed-off-by: Philippe Coval <[email protected]>

Author: rzr

.github/workflows/build-rootfs.yml

@@ -36,6 +36,10 @@ jobs:
           # yamllint disable-line rule:line-length
           name: ${{ github.event.repository.name }}-${{ steps.describe.outputs.describe }}-${{ matrix.arch }}
           path: build/dist/
+      - name: Build documentation once
+        if: startsWith(github.ref, 'refs/tags/') && matrix.arch == 'amd64'
+        run: >-
+          ./scripts/build-rootfs.sh docs/dist
       - name: Upload Release Asset
         id: upload-release-asset
         uses: softprops/action-gh-release@v2
@@ -45,3 +49,23 @@ jobs:
           # yamllint disable-line rule:line-length
           # TODO: Sign asset: https://github.com/softprops/action-gh-release/issues/580#2025
           token: ${{ secrets.GH_UNIFY_ACCESS_TOKEN }}
+      - name: Upload pages artifact
+        id: deployment
+        if: startsWith(github.ref, 'refs/tags/') && matrix.arch == 'amd64'
+        uses: actions/[email protected]
+        with:
+          path: docs/
+  deploy:
+    needs: build
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+        if: startsWith(github.ref, 'refs/tags/')