From 68c45a885e7b4d6e6ead159ac29ba0d6e2677147 Mon Sep 17 00:00:00 2001 From: Lakshay Nasa <76848292+lakshay-nasa@users.noreply.github.com> Date: Fri, 27 Mar 2026 16:44:46 +0530 Subject: [PATCH 1/2] feat: add GitHub Action for automated Docs Archive deployment --- .github/workflows/docs-archive-deploy.yml | 44 +++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 .github/workflows/docs-archive-deploy.yml diff --git a/.github/workflows/docs-archive-deploy.yml b/.github/workflows/docs-archive-deploy.yml new file mode 100644 index 00000000..81394677 --- /dev/null +++ b/.github/workflows/docs-archive-deploy.yml @@ -0,0 +1,44 @@ +name: Docs Archive Vercel Deploy + +on: + push: + branches: + - main + paths: + - "docs-archive/**" + - ".github/workflows/docs-archive-deploy.yml" + workflow_dispatch: + +jobs: + build-and-deploy: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: 18 + cache: npm + cache-dependency-path: docs-archive/package-lock.json + + - name: Install dependencies + working-directory: docs-archive + run: npm ci + + - name: Build Docusaurus site + working-directory: docs-archive + run: | + NODE_OPTIONS="--max-old-space-size=6144" \ + DOCUSAURUS_SSR_CONCURRENCY=1 \ + npm run build + + - name: Deploy to Vercel (prebuilt) + working-directory: docs-archive + run: | + npx vercel deploy --prebuilt --prod --yes \ + --token=${{ secrets.VERCEL_TOKEN }} \ + --org=${{ secrets.VERCEL_ORG_ID }} \ + --project=${{ secrets.VERCEL_PROJECT_ID }} \ No newline at end of file From 4d1958403b89155123a97ddff32e02f43a782577 Mon Sep 17 00:00:00 2001 From: Lakshay Nasa <76848292+lakshay-nasa@users.noreply.github.com> Date: Fri, 27 Mar 2026 18:52:46 +0530 Subject: [PATCH 2/2] fix(docs-archive): remove hardcoded memory from build and document local high-memory build usage --- docs-archive/README.md | 17 ++++++++++++++++- docs-archive/package.json | 3 ++- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/docs-archive/README.md b/docs-archive/README.md index 78bbecb8..b0d198a9 100644 --- a/docs-archive/README.md +++ b/docs-archive/README.md @@ -14,7 +14,7 @@ npm install ``` ### 2. Start the Server -Because this archive contains over a dozen full versions of the documentation, it requires a higher memory heap to compile. You must set the `NODE_OPTIONS` environment variable before starting or building. +Because this archive contains over a dozen full versions of the documentation, it requires a higher memory heap to compile. You may need to set the `NODE_OPTIONS` environment variable before starting or building. ```bash export NODE_OPTIONS=--max-old-space-size=8192 npm start @@ -22,5 +22,20 @@ npm start This command starts a local development server at `http://localhost:3000`. +### 3. Build the Site +For local builds, you may need increased memory: +```bash +export NODE_OPTIONS=--max-old-space-size=8192 +npm run build +``` + +Alternatively, you can use the helper script (recommended): +```bash +npm run build:high-mem +``` + +> On lower memory settings (4GB–6GB), builds may fail due to the size of the archive. + + #### ⚠️ Maintenance Note Do not upgrade this archive to Docusaurus v3. These legacy versions contain historical MDX 1 syntax. Upgrading to v3 (MDX 2) will cause fatal parsing errors across thousands of older files. Treat this directory as a read-only time capsule unless fixing critical broken links or 404s. diff --git a/docs-archive/package.json b/docs-archive/package.json index f996cf61..0c5f5cff 100644 --- a/docs-archive/package.json +++ b/docs-archive/package.json @@ -5,7 +5,8 @@ "scripts": { "docusaurus": "docusaurus", "start": "NODE_OPTIONS='--max-old-space-size=8192' docusaurus start", - "build": "NODE_OPTIONS='--max-old-space-size=8192' docusaurus build", + "build": "docusaurus build", + "build:high-mem": "NODE_OPTIONS='--max-old-space-size=8192' docusaurus build", "swizzle": "docusaurus swizzle", "deploy": "docusaurus deploy", "clear": "docusaurus clear",