Merge branch 'main' of github.com:stellar/stellar-docs into migrate-contract-storage

Author: ElliotFriend

.devcontainer/devcontainer.json

@@ -2,7 +2,7 @@
 // README at: https://github.com/devcontainers/templates/tree/main/src/typescript-node
 {
   "name": "Stellar Docs - Docusaurus/Yarn",
-  "image": "mcr.microsoft.com/devcontainers/typescript-node:1-22",
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:1-24",
   "hostRequirements": {
     "cpus": 2
   },

.github/workflows/build.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'yarn'
           cache-dependency-path: '**/yarn.lock'
 

.github/workflows/crowdin-download-workflow.yml

@@ -71,7 +71,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version: "24"
 
       - name: Install dependencies
         run: yarn install --frozen-lockfile

.github/workflows/crowdin-upload-workflow.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version: "24"
           cache: "yarn"
           cache-dependency-path: "**/yarn.lock"
 

.github/workflows/main.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'yarn'
           cache-dependency-path: '**/yarn.lock'
 

.nvmrc

@@ -1 +1 @@
-v22
+v24

Dockerfile

@@ -8,7 +8,7 @@ ENV DEBIAN_FRONTEND=noninteractive
 ENV INLINE_RUNTIME_CHUNK=false
 RUN apt-get update && apt-get install --no-install-recommends -y gpg curl git make ca-certificates apt-transport-https && \
     curl -sSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key|gpg --dearmor >/etc/apt/trusted.gpg.d/nodesource-key.gpg && \
-    echo "deb https://deb.nodesource.com/node_22.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list && \
+    echo "deb https://deb.nodesource.com/node_24.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list && \
     curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg |gpg --dearmor >/etc/apt/trusted.gpg.d/yarnpkg.gpg && \
     echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list && \
     apt-get update && apt-get install -y nodejs yarn && apt-get clean

README.md

@@ -61,7 +61,7 @@ If you have questions, feel free to ask in the [Stellar Developer Discord](https
 
 To begin development on the documentation, you will first need to install the following:
 
-- Node.js (v22, or higher): see https://nodejs.org/en/download/package-manager for details for your system
+- Node.js (v24, or higher): see https://nodejs.org/en/download/package-manager for details for your system
 - npm: e.g. `sudo apt install npm` on Ubuntu
 - yarn: `npm install yarn`
   - If you're getting dependency errors, try using `npm install yarn --legacy-peer-deps`
@@ -75,7 +75,7 @@ Once all the prerequisites have been installed, you can run the following comman
 git clone https://github.com/stellar/stellar-docs
 cd stellar-docs
 yarn install
-npx docusaurus start
+yarn start
 ```
 
 This will begin the development server, and open a browser window/tab pointing
@@ -86,8 +86,8 @@ After you've made your changes, use the following commands to ensure the consist
 MDX file formatting and style across the repository:
 
 ```bash
-npm run check:mdx # this will search for problems in the MDX files
-npm run format:mdx # this will fix any problems that were found
+yarn check:mdx # this will search for problems in the MDX files
+yarn format:mdx # this will fix any problems that were found
 ```
 
 After that you need to build the `routes.txt` file, to do that run the next command
@@ -258,7 +258,6 @@ export const CODE_LANGS = {
 [commonmark]: https://commonmark.org/help/
 [tutorial]: https://www.markdowntutorial.com/
 [guide]: https://www.markdownguide.org/
-[alert-example]: https://developers.stellar.org/docs/anchoring-assets/enabling-cross-border-payments/setting-up-test-server
 [prism]: https://github.com/FormidableLabs/prism-react-renderer
 [open-in-github-codespaces]: https://github.com/codespaces/new?repo=stellar/stellar-docs&editor=web
 [open-in-code-anywhere]: https://app.codeanywhere.com/#https://github.com/stellar/stellar-docs

config/constants.ts

@@ -39,5 +39,5 @@ export const CODE_LANGS = {
   yaml: 'YAML',
 };
 
-const GOOGLE_TRANSLATE_LANGUAGES: string = "af,sq,am,en,fa,ar,ps,ja,zh-CN,hy,az,eu,be,bn,bs,bg,ca,ceb,ny,zh-TW,co,hr,cs,da,nl,eo,et,tl,fi,fr,fy,gl,ka,de,el,gu,ht,ha,haw,iw,hi,hmn,hu,is,ig,id,ga,it,jw,kn,kk,km,ko,ku,ky,lo,la,lv,lt,lb,mk,mg,ms,ml,mt,mi,mr,mn,my,ne,no,pl,pt,pa,ro,ru,sm,gd,sr,st,sn,sd,si,sk,sl,so,es,su,sw,sv,tg,ta,te,th,tr,uk,ur,uz,vi,cy,xh,yi,yo,zu";
+const GOOGLE_TRANSLATE_LANGUAGES: string = "af,sq,am,en,fa,ar,ps,ja,zh-CN,hy,az,eu,be,bn,bs,bg,ca,ceb,ny,zh-TW,co,hr,cs,da,nl,eo,et,tl,fi,fr,fy,gl,ka,de,el,gu,ht,ha,haw,iw,hi,hmn,hu,is,ig,id,ga,it,jw,kn,kk,km,rw,ko,ku,ky,lo,la,lv,lt,lb,mk,mg,ms,ml,mt,mi,mr,mn,my,ne,no,pl,pt,pa,ro,ru,sm,gd,sr,st,sn,sd,si,sk,sl,so,es,su,sw,sv,tg,ta,te,th,tr,uk,ur,uz,vi,cy,xh,yi,yo,zu";
 export const GOOGLE_TRANSLATE_ELEMENT: string = `<a href="#" class="my-google-translate-button" onclick="new google.translate.TranslateElement({pageLanguage: 'en', includedLanguages: '${GOOGLE_TRANSLATE_LANGUAGES}'}, 'google_translate_element'); return false;"></a>`;

config/theme/navbar.ts

@@ -79,16 +79,26 @@ const build: NavbarItem = {
       label: 'Tutorial: Dapp Frontend',
       activeBasePath: 'docs/build/apps/dapp-frontend',
     },
-    {
-      to: '/docs/build/apps/x402',
-      label: 'x402 on Stellar',
-      activeBasePath: 'docs/build/apps/x402',
-    },
     {
       to: '/docs/build/apps/zk',
       label: 'ZK Proofs on Stellar',
       activeBasePath: 'docs/build/apps/zk',
     },
+    {
+      type: 'html',
+      value: '<hr><a href="/docs/build/agentic-payments" class="subtitle"><small>Agentic Payments</small>',
+      className: 'subtitle',
+    },
+    {
+      to: '/docs/build/agentic-payments/x402',
+      label: 'x402 on Stellar',
+      activeBasePath: 'docs/build/agentic-payments/x402',
+    },
+    {
+      to: '/docs/build/agentic-payments/mpp',
+      label: 'MPP on Stellar',
+      activeBasePath: 'docs/build/agentic-payments/mpp',
+    },
     {
       type: 'html',
       value: '<hr><a href="/docs/build/guides" class="subtitle"><small>How-To Guides</small>',