Skip to content

Restructure top-level navigation#1420

Merged
SahilAujla merged 45 commits into
mainfrom
nav-restructure-mockup
Jul 10, 2026
Merged

Restructure top-level navigation#1420
SahilAujla merged 45 commits into
mainfrom
nav-restructure-mockup

Conversation

@SahilAujla

@SahilAujla SahilAujla commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Restructures the docs top-level navigation. New tabs: Chains · Data · Wallets · Build with AI · Tools & Resources · Changelog.

  • Node merged into Chains: cross-chain WebSockets / Yellowstone gRPC / Trace / Debug live in the Introduction group, per-chain sections follow (each ordered Quickstart → API overview → endpoints → FAQ).
  • Rollups rehomed under Chains ("Launch Your Own Chain") until full removal; Build with AI promoted to its own tab; Get Started renamed Tools & Resources, landing on Pricing.

URL safety: all pages and API specs preserved; exactly 18 URLs move and every one is redirect-covered (audit in comments), plus a node → chains catch-all that recovers ~290 legacy links. Daikon temporal workflows verified compatible.

Live preview · Merge before OMGWINNING/docs-site#344.

🤖 Generated with Claude Code

Reorganizes the docs tabs to match how users look for information:

- Merge the Node tab into Chains: the Node API is our implementation of
  the standard JSON-RPC API, but the actual APIs live under Chains. The
  Chains tab now opens with an Introduction (Chain APIs Overview, Node
  API Overview, Supported Chains, MEV Protection, Pricing) followed by
  the cross-chain WebSockets, Yellowstone gRPC, Trace API, and Debug API
  sections and then the per-chain sections.
- Remove the deprecated Rollups tab from top level; its pages get a
  temporary home at the bottom of Chains as "Launch Your Own Chain
  (Rollups)" until deprecation is communicated to all customers.
- Promote Build with AI to its own top-level tab for visibility.
- Rename Get Started to "Tools & Resources" (tab key: resources). The
  tab keeps the "tutorials" slug so existing URLs are unchanged; the
  Get Started page is slated to become the docs homepage in a follow-up.

All 616 pages and every API spec reference are preserved. MDX pages pin
their URLs via frontmatter slugs, so only nav-generated endpoint URLs
under /docs/node/... move; wildcard redirects cover those, and existing
redirect destinations into the moved trees are repointed to avoid
double hops.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Jul 9, 2026, 10:49 PM

SahilAujla and others added 28 commits July 2, 2026 16:01
- Nest the cross-chain sections (WebSockets, Yellowstone gRPC, Trace API,
  Debug API, Rollups) inside the chains tab's Introduction section: the
  docs site's chain selector treats every top-level section after the
  first as a chain. skip-slug keeps endpoint URLs at /chains/<section>/.
- Rename the resources tab key back to get-started (display name stays
  "Tools & Resources") so the frontend header's active-tab matching and
  the /docs/get-started landing link keep working.
- Pin the Build with AI overview at /docs/build-with-ai as the landing
  page for the new top-level tab, with a redirect from the old
  /docs/build-with-ai-overview URL.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… page

Both sections now live in the same Chains tab, so the two overview pages
are combined into a single API Overview at /docs/chains. The old
/docs/node URL redirects there, and the Tools & Resources landing page
now points its card and prose at the merged page. Also fixes the Trace
API card link, which pointed at the Transfers API quickstart.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
It is Solana-only, so it belongs with Solana rather than in the
cross-chain Introduction group. All its pages keep their pinned
/docs/reference/yellowstone-grpc-* URLs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ources

All pages keep their pinned /docs/* URLs; nav-only move.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…s & Resources

/docs/get-started stays routable for old links and redirects but is out
of the sidebar and search. The tab's landing page is now Pricing Plans
(header change in docs-site).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ing group

All pages keep pinned /docs/reference/* URLs; section slug unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Audit findings from the nav restructure:
- addEvmChainHelpers generated method links into the removed /docs/node/
  tree for newly added chains; now /docs/chains/ (matches actual endpoint
  URLs, which lived under the chains tab already)
- Algolia chain-title disambiguation treated the chains tab's first
  ancestor section as a chain name, which would title methods under the
  new cross-chain Introduction grouping as 'method - Introduction'.
  Breadcrumbs now carry a skipSlug marker and skip-slug groupings yield
  no chain suffix. Regression test added.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The bot hard-requires the chains tab key, inserts new chains before the
next '- tab:' line (silent no-op if chains is last), and scans only
top-level sections for per-chain api entries. Audit finding; comment
only.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Rewrites the stub page (same slug) with the FeatureSupportMatrix widget
embed and the feature-support:auto marker block that
UpdateFeatureSupportFromDaikonWorkflow maintains (AX-545). Prose outside
the markers stays human-owned, exactly like the CU costs page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0152TGB1HprVNykx38Er8dwW
Codex review: the seed commit rendered <FeatureSupportMatrix /> with no
data file in the tree. The embed and its intro paragraph move to the
stacked data PR so this commit is safe to deploy on its own.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Generated by running the AX-545 feature-support generator locally
against the latest prod chain-config (same computation
UpdateFeatureSupportFromDaikonWorkflow will run daily): 40 products and
897 public methods across 153 PUBLIC networks on 79 chains. Only
Availability.PUBLIC dashboard networks appear — methods whose networks
are all private (e.g. TON) are absent entirely. Network-agnostic
products (Wallet APIs, Embedded Accounts, Portfolio, Prices) are marked
networkAgnostic instead of pointing at a pseudo-network.

This PR doubles as the accuracy audit before the automation ever runs:
please review the support data like the CU costs drift audit. Once the
dashboard workflow stack is deployed, a manual dryRun should report
already-up-to-date against this content.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0152TGB1HprVNykx38Er8dwW
…data

Codex review on the stack: OPT_SEPOLIA had mainnet=true because the
dashboard config names it "OP Mainnet Sepolia" and the name-based
detection tripped on it; the embed moves here from the seed commit so
the widget never ships without data.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Regenerated with the fixed Daikon generator (OMGWINNING/dashboard#8095):
the Ethereum beacon networks serve only the Beacon REST API, so
ETH_MAINNETBEACON, ETH_SEPOLIABEACON, and ETH_HOODIBEACON no longer
appear on the chain-level EVM/debug/trace/token/simulate rows and stay
scoped to the eth-beacon rows. Output matches the generator byte for
byte again, so the post-merge dry run stays a no-op.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0152TGB1HprVNykx38Er8dwW
…tion

The freshness path is invisible from this repo alone and kept coming up
in review: the widget reads the JSON through the docs-site
/api/feature-support route (one hour cache TTL against GitHub), never
through the page build, so the revalidation workflow correctly stays
scoped to MDX content.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The real TRON node endpoint is /wallet/createspendauthsig (verified
against the upstream TRON API reference), matching the generated
feature-support data and the CU costs page; the spec's extra s would
404 for anyone copying the path.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Regenerated with the rundler-group scoping fix (OMGWINNING/dashboard#8095):
the Solana paymaster entries back the fee-payer sponsorship product, not the
ERC-4337 methods, so SOLANA_DEVNET/SOLANA_MAINNET leave the 23 EVM
bundler/paymaster rows while alchemy_requestFeePayer keeps them.
TRON's SpendAuthSigParameters proto takes ask, tx_hash, and alpha and
the endpoint returns a BytesMessage value, so the request schema and
examples now match what the node actually accepts.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…he JSON

The daily workflow resolves support data once and writes the JSON file
and the marker-block table together, so the static summary cannot drift
from what the widget serves.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Chain-config enabled 19 EVM and debug methods on BOB_SEPOLIA on July 3,
so those method rows now include the network. Regenerated with the
feature-support generator against current chain-config master; no other
rows change.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Drops the daily-regeneration sentence and the em dash from the page
intro; the freshness details stay in the MDX comment below.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The product-by-chain block exists for search engines, LLMs, and
markdown consumers; the interactive widget is the human-facing view, so
the block now sits in a hidden div with an h4 that stays out of the
table of contents. Verified the generator regenerates the wrapped page
byte-identically.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Matches the data branch: the block exists for search engines, LLMs, and
markdown consumers, so the seed ships it inside the same hidden div and
the section never renders visibly between the two merges.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The interactive matrix covers product and chain support on the page
itself, so the closing pointer to the dashboard Chains page is no
longer needed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Matches the data branch, which removes the closing pointer to the
dashboard Chains page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…/ax-545-feature-support-data

The seed branch gained the same hidden summary wrapper and callout
removal; the data branch page already carries both plus the widget, so
the page resolves to the data branch copy.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
SahilAujla and others added 3 commits July 7, 2026 21:04
The dashboard supported_products config carries the per-network truth
for these chain-agnostic products, so the 10 Portfolio and 3 Prices
method rows now list their real networks (tokens on 59, NFTs on 49,
transfers on 61, prices on 22, Stellar rows on Stellar) instead of
rendering as available on every network. Regenerated output of the
generator change on OMGWINNING/dashboard#8095.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The Node tab is merged into Chains; the page keeps its pinned URL.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…lchemyplatform/docs into nav-restructure-mockup
@SahilAujla SahilAujla changed the base branch from main to sahilaujla/ax-545-feature-support-data July 8, 2026 18:28
@SahilAujla

SahilAujla commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator Author

Full re-audit: redirects, merged/incoming PR stacks, Temporal workflows, tab/nav/filename coupling

Re-ran the complete audit against the current state (branch now carries the feature-support stack + latest main, incl. the merged CU-costs stack).

1. Redirects — clean, zero 404 risk

Diffed the branch's routing table (4,761 routes) against current main (4,762). Only differences: the 18 intentionally moved URLs (/docs/node, its trace/debug endpoint pages, /docs/build-with-ai-overview) — all redirect-covered in one hop, zero unexplained gaps, zero existing redirect destinations regressed. (Also merged latest main into this branch mid-audit to close a 68-route staleness gap from recent Daikon spec updates — preview now matches main everywhere except the intentional moves.)

2 & 3. Temporal workflows (OMGWINNING/dashboard, temporal-worker/src/workflows/daikon-docs/) — all four compatible

4. Code coupling sweep (docs-site + content-indexer) — clean, tests green

  • docs-site: 622/622 tests pass. Merged widget code has zero nav coupling (its "chains" are Daikon data dimensions); preview mechanics compose correctly; all prior fixes (header tab ids, llms.ts on item.tab, chain-selector contract) intact post-merge.
  • content-indexer: 234/234 tests pass. feature-support.json is correctly invisible to the indexer (nav-driven scanning; watchers filter to mdx/md) — matches its runtime-fetch design. All nav paths resolve on disk; docs.yml satisfies every Daikon-bot constraint.

🤖 Generated with Claude Code

…Rollups

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@SahilAujla

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ae3a83564c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/openrpc/chains/bob/bob.yaml
@SahilAujla

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ae3a83564c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/redirects.yml
… URLs

~290 legacy redirect destinations still point at /docs/node/<chain>/...
from the era when chains lived under the node tab; with the node tab
gone they now resolve via /docs/chains. Verified against the branch
routing table: 291 destinations recover, zero redirect loops.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@SahilAujla

Copy link
Copy Markdown
Collaborator Author

@codex review

@SahilAujla SahilAujla marked this pull request as ready for review July 8, 2026 21:24
@SahilAujla SahilAujla requested a review from a team as a code owner July 8, 2026 21:24

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ea277d1f91

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/api-reference/node-api/chain-apis-overview.mdx
@SahilAujla

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Can't wait for the next one!

Reviewed commit: ea277d1f91

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

SahilAujla and others added 3 commits July 9, 2026 13:29
…ub.com:alchemyplatform/docs into nav-restructure-mockup"

This reverts commit 06a3053, reversing
changes made to c83289c.
Reverts the sahilaujla/ax-545-feature-support-data merge so this branch
ships the nav restructure independently (feature support lands later on
its own), and restores files the revert regressed that main already
owns (bot spec/content updates that had ridden along in the merge).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…race/Debug

All its pages keep pinned /docs/reference/yellowstone-grpc-* URLs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@SahilAujla SahilAujla changed the base branch from sahilaujla/ax-545-feature-support-data to main July 9, 2026 17:31
@SahilAujla

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep it up!

Reviewed commit: f1cc1f902c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@SahilAujla SahilAujla changed the title Restructure top-level navigation (mockup) Restructure top-level navigation Jul 9, 2026
Comment thread content/redirects.yml Outdated
/reference/node-api-overview already covers the /docs-prefixed form
since the site loader normalizes every source to the /docs prefix.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@SahilAujla SahilAujla merged commit 181f472 into main Jul 10, 2026
10 checks passed
@SahilAujla SahilAujla deleted the nav-restructure-mockup branch July 10, 2026 00:58
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.

2 participants