From 7e983be72e94b364f916920d7f426e5c598304ea Mon Sep 17 00:00:00 2001 From: danielporterda Date: Tue, 9 Jun 2026 10:00:58 -0400 Subject: [PATCH 1/7] Add external snippet wrapper CI guard --- .github/workflows/mintlify-validate.yml | 3 +++ package.json | 1 + 2 files changed, 4 insertions(+) diff --git a/.github/workflows/mintlify-validate.yml b/.github/workflows/mintlify-validate.yml index ab5861256..47c4356c8 100644 --- a/.github/workflows/mintlify-validate.yml +++ b/.github/workflows/mintlify-validate.yml @@ -24,5 +24,8 @@ jobs: - name: Set up Nix uses: cachix/install-nix-action@v31 + - name: Validate external snippet wrapper + run: nix-shell --run 'npm run test:external-snippets' + - name: Run Mintlify validation run: nix-shell --run 'cd docs-main && npx mint validate' diff --git a/package.json b/package.json index 06ccecbe6..6c1a669b9 100644 --- a/package.json +++ b/package.json @@ -15,6 +15,7 @@ "generate:network-variable-tabs": "python3 scripts/generate_network_variable_tabs.py", "validate:network-variable-tabs": "python3 scripts/validate_network_variable_tabs.py", "validate:splice-mintlify-openapi-nav": "python3 scripts/validate_splice_mintlify_openapi_nav.py", + "test:external-snippets": "python3 -m pytest tests/test_generate_external_snippets.py", "generate:typescript-bindings-reference": "python3 scripts/generate_typescript_bindings_reference.py", "dev": "cd docs-main && mintlify dev" }, From 8966c125af4c14ecce98ea8fce3369207d0a282a Mon Sep 17 00:00:00 2001 From: danielporterda Date: Tue, 9 Jun 2026 11:03:21 -0400 Subject: [PATCH 2/7] Rename docs validation workflow --- .../{mintlify-validate.yml => docs-validation.yml} | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) rename .github/workflows/{mintlify-validate.yml => docs-validation.yml} (79%) diff --git a/.github/workflows/mintlify-validate.yml b/.github/workflows/docs-validation.yml similarity index 79% rename from .github/workflows/mintlify-validate.yml rename to .github/workflows/docs-validation.yml index 47c4356c8..e622e29bb 100644 --- a/.github/workflows/mintlify-validate.yml +++ b/.github/workflows/docs-validation.yml @@ -1,4 +1,4 @@ -name: Mintlify validate +name: Docs validation on: pull_request: @@ -10,12 +10,12 @@ permissions: contents: read concurrency: - group: mintlify-validate-${{ github.workflow }}-${{ github.ref }} + group: docs-validation-${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: - mintlify-validate: - name: mintlify validate + docs-validation: + name: docs validation runs-on: ubuntu-latest steps: - name: Checkout repository From 16f6cc377224eda10cad9ea40e62bf0485f1d8ca Mon Sep 17 00:00:00 2001 From: danielporterda Date: Wed, 10 Jun 2026 10:00:31 -0400 Subject: [PATCH 3/7] Restore Mintlify validate check context --- .github/workflows/docs-validation.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/docs-validation.yml b/.github/workflows/docs-validation.yml index e622e29bb..47c4356c8 100644 --- a/.github/workflows/docs-validation.yml +++ b/.github/workflows/docs-validation.yml @@ -1,4 +1,4 @@ -name: Docs validation +name: Mintlify validate on: pull_request: @@ -10,12 +10,12 @@ permissions: contents: read concurrency: - group: docs-validation-${{ github.workflow }}-${{ github.ref }} + group: mintlify-validate-${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: - docs-validation: - name: docs validation + mintlify-validate: + name: mintlify validate runs-on: ubuntu-latest steps: - name: Checkout repository From 3fb1c9c40bd54099691e3878a686ddf1bc7b6830 Mon Sep 17 00:00:00 2001 From: danielporterda Date: Wed, 10 Jun 2026 10:19:40 -0400 Subject: [PATCH 4/7] Rename docs validation check --- .github/workflows/docs-validation.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/docs-validation.yml b/.github/workflows/docs-validation.yml index 47c4356c8..e622e29bb 100644 --- a/.github/workflows/docs-validation.yml +++ b/.github/workflows/docs-validation.yml @@ -1,4 +1,4 @@ -name: Mintlify validate +name: Docs validation on: pull_request: @@ -10,12 +10,12 @@ permissions: contents: read concurrency: - group: mintlify-validate-${{ github.workflow }}-${{ github.ref }} + group: docs-validation-${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: - mintlify-validate: - name: mintlify validate + docs-validation: + name: docs validation runs-on: ubuntu-latest steps: - name: Checkout repository From 6bdb45e6fa6642e8fa0279ef172060a3d2ff9510 Mon Sep 17 00:00:00 2001 From: danielporterda Date: Wed, 10 Jun 2026 11:57:42 -0400 Subject: [PATCH 5/7] Rename codegen validation check --- .github/workflows/docs-validation.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/docs-validation.yml b/.github/workflows/docs-validation.yml index e622e29bb..917325a5c 100644 --- a/.github/workflows/docs-validation.yml +++ b/.github/workflows/docs-validation.yml @@ -1,4 +1,4 @@ -name: Docs validation +name: Codegen validation on: pull_request: @@ -10,12 +10,12 @@ permissions: contents: read concurrency: - group: docs-validation-${{ github.workflow }}-${{ github.ref }} + group: codegen-validation-${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: - docs-validation: - name: docs validation + codegen-validation: + name: Codegen validation runs-on: ubuntu-latest steps: - name: Checkout repository From cbf6d683ca039127d2876a7515ab44d3a835933d Mon Sep 17 00:00:00 2001 From: danielporterda Date: Wed, 10 Jun 2026 11:59:15 -0400 Subject: [PATCH 6/7] Rename docs generation validation check --- .github/workflows/docs-validation.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/docs-validation.yml b/.github/workflows/docs-validation.yml index 917325a5c..f15b11363 100644 --- a/.github/workflows/docs-validation.yml +++ b/.github/workflows/docs-validation.yml @@ -1,4 +1,4 @@ -name: Codegen validation +name: Docs generation validation on: pull_request: @@ -10,12 +10,12 @@ permissions: contents: read concurrency: - group: codegen-validation-${{ github.workflow }}-${{ github.ref }} + group: docs-generation-validation-${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: - codegen-validation: - name: Codegen validation + docs-generation-validation: + name: Docs generation validation runs-on: ubuntu-latest steps: - name: Checkout repository From 50b626262be2c69aa0dae2c6c2497c8e0c4c3031 Mon Sep 17 00:00:00 2001 From: danielporterda Date: Wed, 10 Jun 2026 12:34:13 -0400 Subject: [PATCH 7/7] Keep Mintlify validate check in snippet guard --- .../{docs-validation.yml => mintlify-validate.yml} | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) rename .github/workflows/{docs-validation.yml => mintlify-validate.yml} (75%) diff --git a/.github/workflows/docs-validation.yml b/.github/workflows/mintlify-validate.yml similarity index 75% rename from .github/workflows/docs-validation.yml rename to .github/workflows/mintlify-validate.yml index f15b11363..47c4356c8 100644 --- a/.github/workflows/docs-validation.yml +++ b/.github/workflows/mintlify-validate.yml @@ -1,4 +1,4 @@ -name: Docs generation validation +name: Mintlify validate on: pull_request: @@ -10,12 +10,12 @@ permissions: contents: read concurrency: - group: docs-generation-validation-${{ github.workflow }}-${{ github.ref }} + group: mintlify-validate-${{ github.workflow }}-${{ github.ref }} cancel-in-progress: true jobs: - docs-generation-validation: - name: Docs generation validation + mintlify-validate: + name: mintlify validate runs-on: ubuntu-latest steps: - name: Checkout repository