Migration of the documentation to a major version

.firebaserc

@@ -2,4 +2,4 @@
   "projects": {
     "default": "astar-docs"
   }
-}
+}

.github/actions/setup-workspace/action.yml

@@ -0,0 +1,34 @@
+name: Setup Workspace
+description: Setup Node.js, Yarn v4 with Corepack, and install dependencies
+inputs:
+  build:
+    description: 'Whether to run `yarn build` after install'
+    required: false
+    default: 'false'
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Node.js (no cache)
+      uses: actions/setup-node@v3
+      with:
+        node-version: 22.x
+
+    - name: Enable Corepack
+      run: corepack enable
+      shell: bash
+
+    - name: Setup Node.js (with Yarn cache)
+      uses: actions/setup-node@v3
+      with:
+        node-version: 22.x
+        cache: yarn
+
+    - name: Install dependencies with Yarn
+      run: yarn install --frozen-lockfile
+      shell: bash
+
+    - name: Build project (optional)
+      if: inputs.build == 'true'
+      run: yarn build
+      shell: bash

.github/release.yml

@@ -22,4 +22,4 @@ changelog:
         - bug
     - title: 🗣️ Translation
       labels:
-        - translation
+        - translation

.github/workflows/broken-links.yml

@@ -10,16 +10,13 @@ jobs:
   build_and_check:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup workspace and build
+        uses: ./.github/actions/setup-workspace
         with:
-          node-version: 18.x
-          cache: yarn
-
-      - name: Install and build
-        run: |
-          yarn install --frozen-lockfile
-          yarn build
+          build: 'true'
 
       - name: Link Checker
         id: lychee
@@ -35,4 +32,4 @@ jobs:
         with:
           title: Link Checker Report
           content-filepath: ./lychee/out.md
-          labels: report, automated issue
+          labels: report, automated issue

.github/workflows/enforce-labels.yml

@@ -10,5 +10,4 @@ jobs:
     - uses: yogevbd/enforce-label-action@2.1.0
       with:
         REQUIRED_LABELS_ANY: "ci,bug,documentation,duplicate,enhancement,good first issue,help wanted,invalid,question,translation,wontfix,dependencies"
-        REQUIRED_LABELS_ANY_DESCRIPTION: "Select at least one label ['ci', 'bug','documentation','duplicate','enhancement','good first issue','help wanted','invalid','question','translation','wontfix','dependencies']"
-
+        REQUIRED_LABELS_ANY_DESCRIPTION: "Select at least one label ['ci', 'bug','documentation','duplicate','enhancement','good first issue','help wanted','invalid','question','translation','wontfix','dependencies']"

.github/workflows/firebase-hosting-merge.yml

@@ -10,21 +10,18 @@ jobs:
   build_and_deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 18.x
-          cache: yarn
+      - name: Checkout repository
+        uses: actions/checkout@v4
 
-      - name: Install and build
-        run: | 
-          yarn install --frozen-lockfile
-          yarn build
+      - name: Setup workspace and build
+        uses: ./.github/actions/setup-workspace
+        with:
+          build: 'true'
 
       - uses: FirebaseExtended/action-hosting-deploy@v0
         with:
           repoToken: '${{ secrets.GITHUB_TOKEN }}'
           firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT_ASTAR_DOCS }}'
           channelId: live
           projectId: astar-docs
-          firebaseToolsVersion: 13.35.1
+          firebaseToolsVersion: 13.35.1

.github/workflows/firebase-hosting-pull-request.yml

@@ -12,20 +12,17 @@ jobs:
     if: '${{ github.event.pull_request.head.repo.full_name == github.repository }}'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v3
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup workspace and build
+        uses: ./.github/actions/setup-workspace
         with:
-          node-version: 18.x
-          cache: yarn
+          build: 'true'
 
-      - name: Install and build
-        run: |
-          yarn install --frozen-lockfile
-          yarn build
-
       - uses: FirebaseExtended/action-hosting-deploy@v0
         with:
           repoToken: '${{ secrets.GITHUB_TOKEN }}'
           firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT_ASTAR_DOCS }}'
           projectId: astar-docs
-          firebaseToolsVersion: 13.35.1
+          firebaseToolsVersion: 13.35.1

.github/workflows/md-link-checker.yml

@@ -16,4 +16,4 @@ jobs:
     - uses: gaurav-nelson/github-action-markdown-link-check@0a51127e9955b855a9bbfa1ff5577f1d1338c9a5 # 1.0.14
       with:
         use-quiet-mode: 'yes'
-        config-file: '.github/workflows/mlc_config.json'
+        config-file: '.github/workflows/mlc_config.json'

.github/workflows/monthly-release.yml

@@ -65,4 +65,4 @@ jobs:
         with:
           tag_name: ${{ steps.create_tag.outputs.new_tag }}
           release_name: Release ${{ steps.create_tag.outputs.new_tag }}
-          body: ${{ steps.create_release_note.outputs.changelog }}
+          body: ${{ steps.create_release_note.outputs.changelog }}

.github/workflows/s3-merge.yml

@@ -7,20 +7,19 @@ jobs:
   build_and_deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v3
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup workspace and build
+        uses: ./.github/actions/setup-workspace
         with:
-          node-version: 18.x
-          cache: yarn
+          build: 'true'
 
-      - name: Install and build
-        run: | 
-          yarn install --frozen-lockfile
-          yarn build
       - uses: aws-actions/configure-aws-credentials@v1
         with:
           aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
           aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
           aws-region: ${{ secrets.AWS_REGION }}
+
       - name: Deploy app build to S3 bucket
-        run: aws s3 sync ./build  s3://astar-docs --delete
+        run: aws s3 sync ./build  s3://astar-docs --delete

.gitignore

@@ -1,31 +1,73 @@
-# Dependencies
-/node_modules
+# ------------------------
+# ⚙️ Node / Yarn / Docusaurus
+# ------------------------
 
-# Production
-/build
+# Node modules (legacy, if nodeLinker: node-modules)
+node_modules/
 
-# Generated files
-.docusaurus
-.cache-loader
+# Docusaurus build output
+build/
+!docs/build/
+.docusaurus/
 
-# Misc
-.DS_Store
+# Yarn v2+ PnP (Zero-install support)
+.yarn/*
+!.yarn/cache
+!.yarn/releases
+!.yarn/plugins
+!.yarn/sdks
+!.yarn/versions
+.pnp.*
+.yarnrc.yml
+
+# ------------------------
+# 📝 Config / Env files
+# ------------------------
+
+.env
 .env.local
 .env.development.local
 .env.test.local
 .env.production.local
 
+# ------------------------
+# 🛠️ Editor / System
+# ------------------------
+
+# VS Code
+.vscode/
+# JetBrains
+.idea/
+# Vim / Swap
+*.swp
+# macOS
+.DS_Store
+# Windows
+Thumbs.db
+
+# ------------------------
+# 🧪 Tests / Debug
+# ------------------------
+
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-# yarn v2
-.yarn/*
-.yarnrc.yml
-!.yarn/cache # Uncomment for zero-install
-!.yarn/releases
-!.yarn/plugins
-!.yarn/sdks
-!.yarn/versions
-# .pnp.* # Comment for zero-install
-package.json
+# ------------------------
+# 🧱 TypeScript
+# ------------------------
+
+*.tsbuildinfo
+
+# ------------------------
+# 📊 Output / Coverage
+# ------------------------
+
+coverage/
+
+# ------------------------
+# 🔥 Firebase (optional)
+# ------------------------
+
+.firebase/
+.firebaserc

.nvmrc

@@ -1 +1 @@
-v18.0
+22.17.0