Skip to content

chore: hide placeholder pages, add redirects, final stage to merge#538

Merged
kpachhai merged 35 commits into
devfrom
chore/hide-placeholder-pages
May 29, 2026
Merged

chore: hide placeholder pages, add redirects, final stage to merge#538
kpachhai merged 35 commits into
devfrom
chore/hide-placeholder-pages

Conversation

@theekrystallee

@theekrystallee theekrystallee commented May 15, 2026

Copy link
Copy Markdown
Member

Description:

Related issue(s):

Fixes #558

#543 #555 #535

Notes for reviewer:

Checklist

  • Documented (Code comments, README, etc.)
  • Tested (unit, integration, etc.)

theekrystallee and others added 15 commits May 14, 2026 20:02
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
…rt spelling to one word

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
- Restore 9 hedera/ source files deleted during bad merge conflict resolution:
  hiero-hooks, hiero-cli feature-coverage-gap-report, 6 hiero-cli plugins
  (batch, contract, contract-erc20, contract-erc721, schedule, swap),
  and foundry forking-advanced-hts tutorial
- Restore evm/tools/foundry/forking-advanced-hts.mdx destination file
  (was in nav but missing from disk)
- Sync revamp/docs.json with docs.json: apply brand color (#8259EF),
  logo href (docs.hedera.com), remove pages:[index] top-level entry
- Fix solutions/index nav regression: remove blank-space group hack,
  restore solutions/index as first page under Tokenization group
- All 12 verify.sh checks pass

Signed-off-by: Kiran Pachhai <kiran.pachhai@hashgraph.com>
Hardcoded https://docs.hedera.com/ breaks local dev and staging.
Using / resolves to the site root in any environment.

Signed-off-by: Kiran Pachhai <kiran.pachhai@hashgraph.com>
…cements

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
…cements

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
- Remove dead import of StudiosShowcase from index.mdx
  (studios-showcase.jsx does not exist; component never used)
- Sync revamp/docs.json: apply Tokens group page order change
  (tokens/index before services/tokens, matching docs.json)

Signed-off-by: Kiran Pachhai <kiran.pachhai@hashgraph.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
@theekrystallee theekrystallee self-assigned this May 15, 2026
@theekrystallee theekrystallee requested review from a team as code owners May 15, 2026 22:53
@kpachhai

Copy link
Copy Markdown
Contributor

Did a quick diff against dev. Couple of things:

  • Typo fix (pushed): evm/overview/why-hedera-for-evm.mdx had yhidden: true instead of hidden: true in the original commit, so that page was not actually being hidden. Pushed a one-line fix on top of the branch
  • Hidden ≠ unreachable: landing-page links still point at placeholder pages. hidden: true in Mintlify only removes a page from the auto-generated sidebar. The page is still routable, and any hand-written <a href> / <Card href> from another page renders normally and clicks through to the "Coming Soon" placeholder.

There were around 36 different links to these placeholder pages still on some pages which we need to decide how to handle. To actually hide the placeholder pages on hedera docs so users can't reach them from anywhere, I think we need to decide what to do with those 36 links. Three options:

  1. Option A: Remove the cards entirely: Delete <a> / <Card> blocks. Simplest. Cost: landing pages lose tiles, especially EVM (10 titles) and Solutions (5 titles), which will look thin until content lands.
  2. Option B: Repoint each card to its first real child page. Keep the card, change the href. E.g.:
  • /evm/development/index/evm/development/creating (real content)
  • /evm/quickstart/index/evm/quickstart/setup-metamask
  • /evm/tools/index/evm/tools/contract-builder
  • /evm/integrations/index/evm/integrations/oracles/index
  • /evm/troubleshooting/index → first real troubleshooting page
  • /evm/hedera-services/index/evm/hedera-services/system-contracts/hts
  • etc.
    Visual layout stays intact; users land on real content. Cost: per-link decision on what the "first real child" is for each section. Some sections (solutions/governance, solutions/sustainability, solutions/examples, solutions/tools, support/faq, learn/core-concepts/services) have no real child at all and would fall back to Option A.
  1. Option C: Disabled-card state: Render the tile without an href (or pointing at #), dimmed, with a small "Coming soon" badge. Tells the user the section exists and is coming, without sending them to a "Coming Soon" page they can't do anything with. Cost: small styling component change to support the disabled state.

Which one do we wanna go with @theekrystallee @ed-marquez @LukeForrest-Hashgraph ?

@theekrystallee

theekrystallee commented May 17, 2026

Copy link
Copy Markdown
Member Author

@kpachhai let’s go with option B bc i want to keep the card/tile layout intact. if there are specific items where removing cards makes sense, that’s fine on a base by case basis but the default should be to keep the style/layout of pages. i'll review and fix PR and see what makes sense for each card

@kpachhai

Copy link
Copy Markdown
Contributor

ok went with option B.

In addition,

12 placeholder pages now have real content (frontmatter hidden: true removed):

EVM:

  • evm/troubleshooting/index.mdx
  • evm/hedera-services/system-contracts/exchange-rate.mdx
  • evm/hedera-services/hts-solidity/create-tokens.mdx
  • evm/tutorials/beginner/your-first-token.mdx
  • evm/tools/remix.mdx

Native:

  • native/quickstart/java.mdx
  • native/quickstart/go.mdx

Operators:

  • operators/index.mdx (un-hidden)
  • operators/json-rpc/index.mdx
  • operators/json-rpc/setup.mdx
  • operators/json-rpc/configuration.mdx
  • operators/mirror-node/architecture.mdx

These are very simple pages and should be enough for us(but please verify them) and this also means we don't have to worry about having sections that lead to placeholder pages. this should be fixed now.

Comment thread native/quickstart/go.mdx Outdated
…ic pages

Hides remaining placeholder pages from the sidebar via `hidden: true`, writes
real content for 12 pages that landing-card tiles point at, restores card
layouts on the evm/native landings, and applies review feedback.

Signed-off-by: Kiran Pachhai <kiran.pachhai@hashgraph.com>
@theekrystallee

theekrystallee commented May 19, 2026

Copy link
Copy Markdown
Member Author

ok went with option B.

In addition,

12 placeholder pages now have real content (frontmatter hidden: true removed):

EVM:

  • evm/troubleshooting/index.mdx
  • evm/hedera-services/system-contracts/exchange-rate.mdx
  • evm/hedera-services/hts-solidity/create-tokens.mdx
  • evm/tutorials/beginner/your-first-token.mdx
  • evm/tools/remix.mdx

Native:

  • native/quickstart/java.mdx
  • native/quickstart/go.mdx

Operators:

  • operators/index.mdx (un-hidden)
  • operators/json-rpc/index.mdx
  • operators/json-rpc/setup.mdx
  • operators/json-rpc/configuration.mdx
  • operators/mirror-node/architecture.mdx

These are very simple pages and should be enough for us(but please verify them) and this also means we don't have to worry about having sections that lead to placeholder pages. this should be fixed now.

@ed-marquez @LukeForrest-Hashgraph can we get a quick review of the new content on these pages so we can merge to dev for QA?

@quiet-node can you help review the new json-rpc-relay docs please? they're short so shouldn't take long ☻

Comment thread evm/troubleshooting/index.mdx Outdated
…n, HederaResponseCodes path note, receive() framing, provider list, broken quickstart navigation, and Maven run command

Signed-off-by: Kiran Pachhai <kiran.pachhai@hashgraph.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
… messaging

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
… messaging

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
@theekrystallee theekrystallee changed the title chore: hide placeholder pages, add rrdirects, final stage to merge chore: hide placeholder pages, add redirects, final stage to merge May 28, 2026
Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
… nav/content overlap

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
… on code

Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com>
Signed-off-by: Kiran Pachhai <kiran.pachhai@hashgraph.com>
@kpachhai kpachhai merged commit 943881e into dev May 29, 2026
12 checks passed
@kpachhai kpachhai deleted the chore/hide-placeholder-pages branch May 29, 2026 00:34
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.

4 participants