build-docs.yaml에서 GitHub Pages 배포 작업을 별도의 단계로 분리하여 문서 배포 프로세스를 개선함.

Author: Palbahngmiyine

.github/workflows/build-docs.yaml

@@ -13,11 +13,6 @@ permissions:
 jobs:
   build-docs:
     runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    permissions:
-      contents: read
     steps:
     - name: Checkout
       uses: actions/checkout@v4
@@ -42,6 +37,14 @@ jobs:
         path: docs
         if-no-files-found: error
         retention-days: 14
-    - name: Deploy to GitHub Pages
-      id: deployment
-      uses: actions/deploy-pages@v4
+
+    deploy:
+      environment:
+        name: github-pages
+        url: ${{ steps.deployment.outputs.page_url }}
+      runs-on: ubuntu-latest
+      needs: build
+      steps:
+        - name: Deploy to GitHub Pages
+          id: deployment
+          uses: actions/deploy-pages@v4