Skip to content

chore: replace git submodules with committed generated content#3116

Open
douglance wants to merge 2 commits intomasterfrom
dl/sub
Open

chore: replace git submodules with committed generated content#3116
douglance wants to merge 2 commits intomasterfrom
dl/sub

Conversation

@douglance
Copy link
Contributor

Summary

  • Remove arbitrum-sdk and stylus-by-example git submodules, committing their generated output directly (SDK API docs, Stylus examples, sidebar configs)
  • Simplify build to just docusaurus build — no submodule init, SDK dependency install, or TypeDoc generation at build time
  • Add update-external-content.yml GitHub Actions workflow for manual regeneration from upstream repos via workflow_dispatch

What changed

Area Before After
Build command yarn install-sdk-dependencies && yarn sync-stylus-content && docusaurus build docusaurus build
Vercel install bash scripts/init-submodules.sh && yarn install yarn install
CI checkout submodules: recursive Standard checkout
New contributor setup Must init submodules before yarn start Just yarn start
SDK doc changes Invisible in PRs (gitignored) Visible in PR diffs
Content updates Automatic via submodule pointer Manual via workflow dispatch → PR

Files modified

  • .gitignore — un-ignore sdk-sidebar.js, docs/sdk/, docs/stylus-by-example/
  • docusaurus.config.js — remove docusaurus-plugin-typedoc plugin block
  • package.json — simplify build/start, remove submodule-related scripts
  • vercel.json — simplify installCommand
  • .github/workflows/build.yml — remove submodules: recursive
  • scripts/sync-stylus-content.js — add STYLUS_SOURCE_DIR env var for CI

Files added

  • docs/sdk/**/*.md — 28 SDK API reference docs (previously generated at build time)
  • docs/stylus-by-example/** — 22 Stylus example docs + sidebars
  • sdk-sidebar.js — SDK sidebar config
  • .github/workflows/update-external-content.yml — content update workflow

Files deleted

  • .gitmodules, scripts/init-submodules.sh, submodules/*

Test plan

  • yarn build succeeds with committed content only (no submodules)
  • Vercel preview deploy works without init-submodules.sh
  • SDK docs and Stylus examples render correctly in preview
  • Sidebar navigation for SDK and Stylus sections works

Remove arbitrum-sdk and stylus-by-example submodules, committing their
generated output (SDK API docs, Stylus examples, sidebars) directly.
Build simplifies to just `docusaurus build` — no submodule init, SDK
dependency install, or TypeDoc generation at build time.

Add GitHub Actions workflow (update-external-content.yml) for manual
regeneration from upstream repos via workflow_dispatch.
@vercel
Copy link

vercel bot commented Feb 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
arbitrum-docs Ready Ready Preview Feb 12, 2026 9:59pm

Request Review

Regenerate SDK docs from latest arbitrum-sdk (monorepo structure) and
sync stylus-by-example content from latest upstream.

Also fix: update sdkDocsHandler to clean up TypeDoc-generated README.md,
fix sidebar reference from sdk/index to sdk/sdk-intro, and update CI
workflow for SDK monorepo paths.
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