ci: refactor deploy.yaml workflow

Author: threeal

.github/workflows/deploy.yaml

@@ -1,39 +1,39 @@
-name: deploy
+name: Deploy
 on:
   workflow_dispatch:
   push:
     branches: [main]
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-concurrency:
-  group: pages
-  cancel-in-progress: false
 jobs:
-  docs:
+  deploy-pages:
+    name: Deploy Pages
     runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      pages: write
     environment:
       name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+      url: ${{ steps.deploy-pages.outputs.page_url }}
+    concurrency:
+      group: pages
+      cancel-in-progress: true
     steps:
+      - name: Setup Pages
+        uses: actions/[email protected]
+
       - name: Checkout
         uses: actions/[email protected]
 
-      - name: Install requirements
+      - name: Install Requirements
         run: pip3 install -r docs/requirements.txt
 
-      - name: Setup Pages
-        uses: actions/[email protected]
-
-      - name: Build with Sphinx
+      - name: Build Documentation
         run: sphinx-build -b html docs docs/build -W --keep-going
 
-      - name: Upload artifact
+      - name: Upload Documentation
         uses: actions/[email protected]
         with:
           path: docs/build
 
-      - name: Deploy to GitHub Pages
-        id: deployment
+      - name: Deploy Pages
+        id: deploy-pages
         uses: actions/[email protected]