Skip to content

Remove git submodules, replace with external links#3169

Open
douglance wants to merge 11 commits intomasterfrom
dl/move-submodules
Open

Remove git submodules, replace with external links#3169
douglance wants to merge 11 commits intomasterfrom
dl/move-submodules

Conversation

@douglance
Copy link
Copy Markdown
Contributor

@douglance douglance commented Mar 23, 2026

Summary

  • Remove the arbitrum-sdk and stylus-by-example git submodules
  • Delete the remaining SDK submodule plumbing: scripts/init-submodules.sh, scripts/sdkDocsHandler.ts, and scripts/sdk-sidebar-generator.js
  • Remove the SDK typedoc/submodule config from docusaurus.config.js
  • Replace SDK sidebar entries with external links to the canonical GitHub repo
  • Replace stylus-by-example sidebar entries with links to stylus-by-example.org
  • Update vercel.json so installs no longer run submodule init
  • Update SDK documentation links to the current repo layout and v4 naming
  • Clean up ancillary repo references in README.md, dependencies.json, .gitignore, .gitmodules, package.json, and yarn.lock
  • Preserve the intended branch changes while removing rebase corruption from vercel.json and docusaurus.config.js

Motivation

The submodules added build and CI complexity for content that already has better canonical homes. This change removes the submodule-specific install and docs-generation path while keeping users pointed at the maintained upstream sources.

What Stays

  • The @arbitrum/sdk npm dependency remains because it is still used at runtime by src/components/AddressAliasHelper.tsx
  • Existing /sdk/... traffic is still handled via redirects to the SDK GitHub repo
  • User-facing SDK code samples remain in place

Review Notes

  • Rebase fallout in vercel.json and docusaurus.config.js was reset to trunk and the intended submodule-removal changes were re-applied cleanly
  • Pete's requested SDK link updates were applied and the outdated review threads were resolved

Validation

  • yarn build
  • CI checks green: Build, Install, test, Check Formatting, Vercel, license/cla
  • No tracked references remain to the removed SDK submodule install/docs-generation path

Remove arbitrum-sdk and stylus-by-example submodule infrastructure:
- Delete init-submodules.sh, sdkDocsHandler.ts, stylusByExampleDocsHandler.ts, sdk-sidebar-generator.js
- Remove typedoc plugin config from docusaurus.config.js
- Remove SDK/stylus-by-example sidebar imports and replace with external links
- Clean up .gitignore entries for generated SDK/stylus content
- Remove install-sdk-dependencies from package.json scripts
- vercel.json: remove init-submodules.sh from install command, redirect
  53 dead /sdk/ destinations to GitHub repo
- Replace broken relative ../sdk/ doc links with GitHub source links
- dependabot.yml: replace gitsubmodule with npm ecosystem
- README.md: remove submodule setup instructions and references
- dependencies.json: remove arbitrum-sdk entry with dead docsPath
The arbitrum-sdk repo moved from src/lib/ to packages/sdk/src/lib/.
Also update renamed file L1ToL2MessageGasEstimator.ts →
ParentToChildMessageGasEstimator.ts.
- Rename L1ToL2MessageGasEstimator → ParentToChildMessageGasEstimator
- Rename calculateSubmitRetryableId → ParentToChildMessage.calculateSubmitRetryableId
- Update InboxTools links to main branch with correct packages/sdk path
- Update code comments to use Parent/Child terminology
- Change L1ToL2MessageStatus → ParentToChildMessageStatus in examples
- Note Layer Leap uses SDK v3 teleporter package
Replace broken internal markdown links in docs/sdk/index.mdx and
docs/sdk/migrate.mdx with GitHub URLs now that the auto-generated
SDK docs have been removed along with the submodule.
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 23, 2026

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

Project Deployment Actions Updated (UTC)
arbitrum-docs Ready Ready Preview Mar 30, 2026 8:36pm

Request Review

Restore @floating-ui/react, @ethersproject/address, and mermaid which
are still used by components added to master after the branch diverged.
Regenerate yarn.lock to match package.json.
The rebase introduced 189 missing redirects, 172 wrong destinations,
39 duplicate sources, and stale orbit references. Reset to master's
redirects and kept only the intentional installCommand change.
docusaurus.config.js, .github/dependabot.yml, package.json, and
yarn.lock were corrupted during rebase — losing inkeep analytics,
parseFrontMatter, onBrokenAnchors, and adding unrelated deps like
vitest. Reset all to master and re-applied only the intentional
submodule-removal changes.
Applies pete-vielhaber's 7 review suggestions to use precise line
number anchors instead of fragment-based anchors in SDK source links.
@anegg0
Copy link
Copy Markdown
Contributor

anegg0 commented Mar 24, 2026

Summary

  • Remove the arbitrum-sdk and stylus-by-example git submodules
  • Delete the remaining SDK submodule plumbing: scripts/init-submodules.sh, scripts/sdkDocsHandler.ts, and scripts/sdk-sidebar-generator.js
  • Remove the SDK typedoc/submodule config from docusaurus.config.js
  • Replace SDK sidebar entries with external links to the canonical GitHub repo
  • Replace stylus-by-example sidebar entries with links to stylus-by-example.org
  • Update vercel.json so installs no longer run submodule init
  • Update SDK documentation links to the current repo layout and v4 naming
  • Clean up ancillary repo references in README.md, dependencies.json, .gitignore, .gitmodules, package.json, and yarn.lock
  • Preserve the intended branch changes while removing rebase corruption from vercel.json and docusaurus.config.js

Motivation

The submodules added build and CI complexity for content that already has better canonical homes. This change removes the submodule-specific install and docs-generation path while keeping users pointed at the maintained upstream sources.

What Stays

  • The @arbitrum/sdk npm dependency remains because it is still used at runtime by src/components/AddressAliasHelper.tsx
  • Existing /sdk/... traffic is still handled via redirects to the SDK GitHub repo
  • User-facing SDK code samples remain in place

Review Notes

  • Rebase fallout in vercel.json and docusaurus.config.js was reset to trunk and the intended submodule-removal changes were re-applied cleanly
  • Pete's requested SDK link updates were applied and the outdated review threads were resolved

Validation

  • yarn build
  • CI checks green: Build, Install, test, Check Formatting, Vercel, license/cla
  • No tracked references remain to the removed SDK submodule install/docs-generation path

That looks good to me, but I think we should discuss how to document the Arbitrum SDK references; removing them entirely and leaving a link might be too radical.

Fix missing space before ArbitrumNetwork link in TokenBridge section.
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.

3 participants