Skip to content

Fix external snippet helper copy#718

Draft
danielporterda wants to merge 1 commit into
mainfrom
external-snippet-helper-copy
Draft

Fix external snippet helper copy#718
danielporterda wants to merge 1 commit into
mainfrom
external-snippet-helper-copy

Conversation

@danielporterda

Copy link
Copy Markdown
Contributor

Summary

  • fixes generate:external-snippets after generateOutputDocs.js moved under scripts/helpers
  • copies rstIncludeToMdx.js beside the helper in source repos so the helper can resolve its local require
  • fixes --copy-output to write to docs-main/snippets/external/...
  • removes the stale Splice sv-values.yaml migration snippet/import because latest Splice main no longer has the MIGRATION_START marker

Root cause

PR #662 deleted the root-level scripts/generateOutputDocs.js, but scripts/generate_external_snippets.py still expected that path and copied only one helper file. Current helper code lives under scripts/helpers/ and requires ./rstIncludeToMdx, so the wrapper had to copy both files together.

Validation

  • PYTHONPATH=/tmp/cf-docs-pytest python3 -m pytest tests/test_generate_external_snippets.py tests/test_network_variable_tabs.py
  • PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_network_variable_tabs.py
  • jq empty config/snippet-config/splice-snippet-list-remote.json docs-main/docs.json
  • python3 -m py_compile scripts/generate_external_snippets.py scripts/generate_network_variable_tabs.py tests/test_generate_external_snippets.py
  • node --check scripts/helpers/generateOutputDocs.js
  • node --check scripts/helpers/rstIncludeToMdx.js
  • missing /snippets import scan
  • git diff --check
  • real Splice extraction against a fresh Splice origin/main worktree: 165 succeeded, 0 failed

Follow-up

A broad --replace-output Splice snippet refresh still exposes stale line-number snippets in sv_helm.rst; those should be converted to stable markers or rebaselined before committing broad generated snippet drift.

@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cantonfoundation 🟢 Ready View Preview Jun 9, 2026, 1:23 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant