build: cleanup docs pipeline

.github/workflows/documentation.yml

@@ -26,25 +26,32 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Check out repository
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Set up Python
+
+      - name: Set up Python 3.12
         uses: actions/setup-python@v5
         with:
           python-version: "3.12"
+
       - name: Setup Graphviz
         uses: ts-graphviz/setup-graphviz@v2
+
       - name: Install uv
         uses: yezz123/setup-uv@v4
+
       - name: Install dependencies
-        run: |
-          uv sync --all-extras
-      - name: Build
-        run: |
-          uv run mkdocs build -v
-          uv run mknodes build -d ../site/mkdocs -p configs/mkdocs_mkdocs.yml -v --clone-depth 100
-      - name: Upload artifact
+        run: uv sync --all-extras
+
+      - name: Build main documentation page
+        run: uv run mkdocs build -v
+
+      - name: Build example sub-page (MkDocs)
+        run: uv run mknodes build -d ../site/mkdocs -p configs/mkdocs_mkdocs.yml -v --clone-depth 100
+
+      - name: Package and upload page artifact
         uses: actions/upload-pages-artifact@v3
         with:
           path: ./site