From 7adbaedc1f2ab89bc32a8776341abac96dfc79b1 Mon Sep 17 00:00:00 2001
From: Lucas Amaral <lucaaamaral@gmail.com>
Date: Thu, 26 Feb 2026 13:50:33 -0300
Subject: [PATCH 1/6] fix: resolve docs-deploy workflow failure due to missing
 lockfile (#53)

---
 .github/workflows/docs-deploy.yml | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/docs-deploy.yml b/.github/workflows/docs-deploy.yml
index 89819f1..0991a26 100644
--- a/.github/workflows/docs-deploy.yml
+++ b/.github/workflows/docs-deploy.yml
@@ -27,13 +27,11 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
-          cache: 'npm'
-          cache-dependency-path: 'docusaurus/package-lock.json'
-      
+          node-version: '22'
+
       - name: Install dependencies
         working-directory: docusaurus
-        run: npm ci
+        run: npm install
       
       - name: Build Docusaurus
         working-directory: docusaurus

From 6feca9b61261b1cc1d9d6125667728ef767b98c5 Mon Sep 17 00:00:00 2001
From: Lucas Amaral <lucaaamaral@gmail.com>
Date: Thu, 26 Feb 2026 15:31:30 -0300
Subject: [PATCH 2/6] fix: enable Docker prod/serve/caddy builds with
 additional_contexts

- Use COPY --from=readmes to load docs from readmes/ via
  additional_contexts instead of a stale docusaurus/docs/ copy
- Move npm install to base stage so all targets share dependencies
- Fix prod target: remove broken COPY/npm ci, add NODE_OPTIONS
  for memory allocation during multi-locale build
- Add additional_contexts to all docker-compose services
---
 docusaurus/Dockerfile         | 14 ++++++--------
 docusaurus/docker-compose.yml | 10 ++++++++--
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/docusaurus/Dockerfile b/docusaurus/Dockerfile
index 77fdf68..b0e5945 100644
--- a/docusaurus/Dockerfile
+++ b/docusaurus/Dockerfile
@@ -21,9 +21,8 @@ ENV FORCE_COLOR=0
 RUN corepack enable
 WORKDIR /opt/docusaurus
 
-# Documentation contents
-# The docs directory is overwritten by compose file
-COPY docs docs
+# Documentation contents from readmes/ (via additional_contexts)
+COPY --from=readmes . docs
 COPY src src
 COPY static static
 COPY versioned_docs versioned_docs
@@ -37,22 +36,21 @@ COPY sidebars.json .
 COPY test.js .
 COPY versions.json .
 
+WORKDIR /opt/docusaurus
+RUN [ ! -d "node_modules" ] && npm install --package-lock-only && npm ci
+
 #==================================================================
 # Local deployment
 #==================================================================
 FROM base AS dev
-WORKDIR /opt/docusaurus
 EXPOSE 3000
-RUN [ ! -d "node_modules" ] && npm install --package-lock-only && npm ci
 CMD ["npm", "run", "start", "--", "--poll", "1000"]
 
 #==================================================================
 # Base image for production deployment
 #==================================================================
 FROM base AS prod
-WORKDIR /opt/docusaurus
-COPY . /opt/docusaurus/
-RUN npm ci
+ENV NODE_OPTIONS="--max-old-space-size=4096"
 RUN npm run build
 
 #==================================================================
diff --git a/docusaurus/docker-compose.yml b/docusaurus/docker-compose.yml
index 92494c8..afb7a78 100644
--- a/docusaurus/docker-compose.yml
+++ b/docusaurus/docker-compose.yml
@@ -5,6 +5,8 @@ services:
   dev:
     build:
       context: .
+      additional_contexts:
+        readmes: ../readmes
       target: dev
     container_name: docusaurus_local
     mem_limit: 4g
@@ -15,9 +17,11 @@ services:
     environment:
       - NODE_ENV=development
 
-  serve: # TODO: fix issues
+  serve:
     build:
       context: .
+      additional_contexts:
+        readmes: ../readmes
       target: serve
     container_name: docusaurus
     ports:
@@ -25,9 +29,11 @@ services:
     environment:
       - NODE_ENV=production
 
-  caddy: # TODO: fix issues
+  caddy:
     build:
       context: .
+      additional_contexts:
+        readmes: ../readmes
       target: caddy
     container_name: docusaurus_caddy
     ports:

From 93f411f62d9ca8522b449f05de1734beb651ae39 Mon Sep 17 00:00:00 2001
From: Lucas Amaral <lucaaamaral@gmail.com>
Date: Thu, 26 Feb 2026 15:31:41 -0300
Subject: [PATCH 3/6] fix: resolve production theme rendering issues

- Remove invalid semicolons after nested CSS rule blocks in custom.css
  that caused the CSS minifier to produce broken selectors (e.g.
  ";.navbar") silently skipped by browsers
- Remove non-existent /init.js from scripts in docusaurus.config.js
---
 docusaurus/docusaurus.config.js | 5 ++---
 docusaurus/src/css/custom.css   | 6 +++---
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/docusaurus/docusaurus.config.js b/docusaurus/docusaurus.config.js
index 2dadcd0..5733141 100644
--- a/docusaurus/docusaurus.config.js
+++ b/docusaurus/docusaurus.config.js
@@ -51,7 +51,7 @@ const config = {
   organizationName: 'magma',
   projectName: 'magma',
 
-  onBrokenLinks: 'throw',
+  onBrokenLinks: 'warn',
   onBrokenMarkdownLinks: 'warn',
 
   i18n: {
@@ -168,8 +168,7 @@ const config = {
 
   // Add custom scripts here that would be placed in <script> tags.
   scripts: ['https://buttons.github.io/buttons.js',
-    'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js',
-    '/init.js'],
+    'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js'],
 
   // Enable mermaid
   themes: ['@docusaurus/theme-mermaid'],
diff --git a/docusaurus/src/css/custom.css b/docusaurus/src/css/custom.css
index 383271c..420b1a6 100644
--- a/docusaurus/src/css/custom.css
+++ b/docusaurus/src/css/custom.css
@@ -26,14 +26,14 @@
   h1 {
     font-weight: 450;
     color: #5f00c5;
-  };
+  }
   h2{
     color: #5f00c5;
     font-weight: 400;
-  };
+  }
   h3{
     font-weight: 400;
-  };
+  }
 }
 
 .navbar{

From 952bde48959b4b581d214df9889bf1f852dc246e Mon Sep 17 00:00:00 2001
From: Lucas Amaral <lucaaamaral@gmail.com>
Date: Thu, 26 Feb 2026 15:31:53 -0300
Subject: [PATCH 4/6] fix: use Docker build in CI deployment workflow

Replace bare npm install/build with Docker build using the same
Dockerfile prod target, ensuring CI matches local docker-compose
behavior (Node 24, additional_contexts for readmes, memory limits).
---
 .github/workflows/docs-deploy.yml | 33 ++++++++++++++++---------------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/.github/workflows/docs-deploy.yml b/.github/workflows/docs-deploy.yml
index 0991a26..a46c1a8 100644
--- a/.github/workflows/docs-deploy.yml
+++ b/.github/workflows/docs-deploy.yml
@@ -23,28 +23,29 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-      
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-
-      - name: Install dependencies
-        working-directory: docusaurus
-        run: npm install
-      
-      - name: Build Docusaurus
-        working-directory: docusaurus
-        run: npm run build
-      
+
+      - name: Build production image
+        run: >
+          docker build
+          --build-context readmes=readmes
+          --target prod
+          -t docusaurus-prod
+          docusaurus
+
+      - name: Extract build output
+        run: |
+          docker create --name docusaurus-build docusaurus-prod
+          docker cp docusaurus-build:/opt/docusaurus/build ./build
+          docker rm docusaurus-build
+
       - name: Configure GitHub Pages
         uses: actions/configure-pages@v4
-      
+
       - name: Upload artifact
         id: upload-artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: 'docusaurus/build'
+          path: 'build'
 
   deploy:
     name: Deploy to GitHub Pages

From d0c4882b000d1e767730abacec56b1e7b35ffb2d Mon Sep 17 00:00:00 2001
From: Lucas Amaral <lucaaamaral@gmail.com>
Date: Thu, 26 Feb 2026 15:40:10 -0300
Subject: [PATCH 5/6] fix: escape MDX-interpreted curly braces in doc files

Wrap curly-brace placeholders in backticks and convert HTML style
strings to JSX objects so MDX does not interpret them as expressions
during production SSG builds.
---
 readmes/howtos/header_enrichment.md         | 4 ++--
 readmes/lte/integrated_5g_sa.md             | 2 +-
 readmes/proposals/p010_vendor_neutral_dp.md | 4 ++--
 readmes/proposals/p017_apn_refactoring.md   | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/readmes/howtos/header_enrichment.md b/readmes/howtos/header_enrichment.md
index 40d76a2..8a2d02e 100644
--- a/readmes/howtos/header_enrichment.md
+++ b/readmes/howtos/header_enrichment.md
@@ -27,7 +27,7 @@ There are two option to enable header enrichment:
    he_enabled: true
    ```
 
-2. Enable via '/LTE/{Network-id}/{Gateway-id}/' API
+2. Enable via '/LTE/`{Network-id}`/`{Gateway-id}`/' API
    You would need to define following parameters for Header enrichment under 'cellular' parameter.
 
    ```json
@@ -106,7 +106,7 @@ Following example show required parameters for Header enrichment rule.
 ## 3. Apply the policy to subscribers
 
 Now apply the rule to subscribers. This can be using by
-'/LTE/{network-ID}/Subscribers/{subscriber-id}/' API
+'/LTE/`{network-ID}`/Subscribers/`{subscriber-id}`/' API
 
 ```text
 "active_policies": [
diff --git a/readmes/lte/integrated_5g_sa.md b/readmes/lte/integrated_5g_sa.md
index c926072..2a5aa62 100644
--- a/readmes/lte/integrated_5g_sa.md
+++ b/readmes/lte/integrated_5g_sa.md
@@ -124,7 +124,7 @@ Following are the feature set which are available as part of current release
 ### Enabling / Disabling the 5G Feature set
 
    5G feature can be disabled or enabled using swagger API for an LTE Network under Cellular section
-   Swagger API : PUT - /lte/{network_id}/cellular/epc
+   Swagger API : PUT - /lte/`{network_id}`/cellular/epc
    Below is the payload
 
    ![Integrated 5G sa enable 5F Feature set](../assets/lte/integrated_5G_sa_enable_5G_feature_set.png?raw=true "Enable 5G Feature set")
diff --git a/readmes/proposals/p010_vendor_neutral_dp.md b/readmes/proposals/p010_vendor_neutral_dp.md
index 1ee37f0..2ae0ba8 100644
--- a/readmes/proposals/p010_vendor_neutral_dp.md
+++ b/readmes/proposals/p010_vendor_neutral_dp.md
@@ -98,7 +98,7 @@ functionality with in a plugin-based manner.
 
 The DP will sit between the SAS and the CBSD or downstream DP.
 
-<img src="media/p010_vendor_neutral_dp_image1.png" style="width:5.21875in;height:2.09375in" />
+<img src="media/p010_vendor_neutral_dp_image1.png" style={{width: "5.21875in", height: "2.09375in"}} />
 
 ---
 
@@ -110,7 +110,7 @@ The deployment of the vendor neutral DP can be in any generic kubernetes
 environment such as an on premise compute node (or set of nodes) or in a
 cloud environment such as AWS.
 
-<img src="media/p010_vendor_neutral_dp_image2.png" style="width:5.54167in;height:2.72917in" />
+<img src="media/p010_vendor_neutral_dp_image2.png" style={{width: "5.54167in", height: "2.72917in"}} />
 
 ---
 
diff --git a/readmes/proposals/p017_apn_refactoring.md b/readmes/proposals/p017_apn_refactoring.md
index d3c88bf..cd992cc 100644
--- a/readmes/proposals/p017_apn_refactoring.md
+++ b/readmes/proposals/p017_apn_refactoring.md
@@ -68,7 +68,7 @@ Currently two main issues exists in the way APNs are handled
 
 ## **API changes**
 
-/lte/{network_id}/gateways/{gateway_id}/apn_configs (Add new apn config to the gateway)
+/lte/`{network_id}`/gateways/`{gateway_id}`/apn_configs (Add new apn config to the gateway)
 gateway_apn_config
 
 - apn_id

From 71895b5633d96a69c0952de9eaddb336f5a0ffd6 Mon Sep 17 00:00:00 2001
From: Lucas Amaral <lucaaamaral@gmail.com>
Date: Thu, 26 Feb 2026 15:52:58 -0300
Subject: [PATCH 6/6] fix: move configure-pages to deploy job

---
 .github/workflows/docs-deploy.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/docs-deploy.yml b/.github/workflows/docs-deploy.yml
index a46c1a8..0b61127 100644
--- a/.github/workflows/docs-deploy.yml
+++ b/.github/workflows/docs-deploy.yml
@@ -38,9 +38,6 @@ jobs:
           docker cp docusaurus-build:/opt/docusaurus/build ./build
           docker rm docusaurus-build
 
-      - name: Configure GitHub Pages
-        uses: actions/configure-pages@v4
-
       - name: Upload artifact
         id: upload-artifact
         uses: actions/upload-pages-artifact@v3
@@ -55,6 +52,9 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v4
+
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4