Skip to content

docs: remove beta banner and legacy SDK tab#78

Open
aimensahnoun wants to merge 1 commit into03-03-docs_resources_update_faq_and_glossary_with_legacy-aligned_content_and_accurate_links_refine_faq.mdx_and_glossary.mdx_to_keep_legacy_structure_content_while_removing_migration_artifacts_and_fixing_outdated_references._-_removed_from
03-04-docs_nav_remove_beta_banner_and_hide_sdk_legacy_tab_from_navigation_clean_up_global_docs_navigation_by_removing_the_temporary_beta_status_messaging_and_taking_the_sdk_legacy_tab_out_of_the_top-level_tabs_for_now._-_removed_banne
Open

docs: remove beta banner and legacy SDK tab#78
aimensahnoun wants to merge 1 commit into03-03-docs_resources_update_faq_and_glossary_with_legacy-aligned_content_and_accurate_links_refine_faq.mdx_and_glossary.mdx_to_keep_legacy_structure_content_while_removing_migration_artifacts_and_fixing_outdated_references._-_removed_from
03-04-docs_nav_remove_beta_banner_and_hide_sdk_legacy_tab_from_navigation_clean_up_global_docs_navigation_by_removing_the_temporary_beta_status_messaging_and_taking_the_sdk_legacy_tab_out_of_the_top-level_tabs_for_now._-_removed_banne

Conversation

@aimensahnoun
Copy link
Member

@aimensahnoun aimensahnoun commented Mar 3, 2026

TL;DR

Removed the beta warning banner and legacy SDK documentation section from the docs configuration.

What changed?

  • Removed the beta warning banner that displayed "⚠️ Beta Docs – Welcome page, Payment Demo, Webhooks, and NEAR docs are ready. Use Cases, API, Resources, SDK, and Release Notes are still being revised. View stable docs →"
  • Eliminated the "SDK (Legacy)" tab and its associated "🔧 SDK Documentation" group containing the legacy overview page

How to test?

  1. Build and serve the documentation locally
  2. Verify the beta warning banner no longer appears at the top of pages
  3. Confirm the "SDK (Legacy)" tab is no longer visible in the navigation
  4. Check that all remaining navigation tabs and pages load correctly

Why make this change?

The documentation has likely moved out of beta status, making the warning banner obsolete. The legacy SDK documentation removal suggests a transition to newer SDK versions, streamlining the documentation structure by removing outdated content.

Clean up global docs navigation by removing the temporary beta status messaging
and taking the SDK (Legacy) tab out of the top-level tabs for now.
- removed `banner` block from `docs.json` to eliminate the “Beta Docs” notice
- removed the entire `SDK (Legacy)` tab from `navigation.tabs`
- kept underlying SDK files in the repository untouched (only navigation changed)
- validated `docs.json` structure remains valid
@aimensahnoun aimensahnoun self-assigned this Mar 3, 2026
@aimensahnoun aimensahnoun changed the title docs(nav): remove beta banner and hide SDK legacy tab from navigation Clean up global docs navigation by removing the temporary beta status messaging and taking the SDK (Legacy) tab out of the top-level tabs for now. - removed banner block from `docs.js docs: remove beta banner and legacy SDK ta Mar 3, 2026
@aimensahnoun aimensahnoun changed the title docs: remove beta banner and legacy SDK ta docs: remove beta banner and legacy SDK tag Mar 3, 2026
Copy link
Member Author

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

@aimensahnoun aimensahnoun marked this pull request as ready for review March 3, 2026 21:31
@greptile-apps
Copy link

greptile-apps bot commented Mar 3, 2026

Greptile Summary

This PR removes the beta warning banner and the "SDK (Legacy)" navigation tab from docs.json, streamlining the documentation structure. The banner removal is straightforward and clean, but the tab removal is incomplete — the underlying sdk-legacy/overview.mdx file still exists, and five internal links across three files (glossary.mdx, use-cases/welcome.mdx, resources/lifecycle-of-a-request.mdx) continue to reference /sdk-legacy/overview. Since Mintlify typically only builds and serves pages that are listed in the navigation config, these links will likely resolve to 404s after this change is deployed.

Key changes:

  • Removed the banner block (beta warning with non-dismissible notice and link to stable docs)
  • Removed the SDK (Legacy) tab and its 🔧 SDK Documentation group from the navigation

Issues found:

  • sdk-legacy/overview.mdx is orphaned but not deleted, and 5 inbound links across 3 pages still point to it — these will likely become broken links

Confidence Score: 3/5

  • The PR is safe to merge structurally, but will likely introduce broken links visible to end users.
  • The banner removal is clean and complete. However, removing the SDK (Legacy) tab without cleaning up the five inbound links to sdk-legacy/overview across glossary.mdx, use-cases/welcome.mdx, and resources/lifecycle-of-a-request.mdx — and without deleting the orphaned file — means readers clicking those links will hit 404 errors once the change is deployed.
  • glossary.mdx, use-cases/welcome.mdx, and resources/lifecycle-of-a-request.mdx all contain links to the now-unreferenced /sdk-legacy/overview page.

Important Files Changed

Filename Overview
docs.json Removes the beta banner and the "SDK (Legacy)" navigation tab. The banner removal is clean, but the tab removal leaves sdk-legacy/overview.mdx orphaned while five internal links across three other files still reference /sdk-legacy/overview, likely creating broken links.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    subgraph Before["Before (navigation tabs)"]
        T1[Use Cases]
        T2[API]
        T3[Resources]
        T4["SDK (Legacy)"]
        T4 --> P1["sdk-legacy/overview"]
    end

    subgraph After["After (navigation tabs)"]
        T5[Use Cases]
        T6[API]
        T7[Resources]
    end

    subgraph Orphaned["Still in repo / still linked"]
        F1["sdk-legacy/overview.mdx"]
        L1["glossary.mdx (3 links)"]
        L2["use-cases/welcome.mdx (1 link)"]
        L3["resources/lifecycle-of-a-request.mdx (1 link)"]
        L1 -->|"/sdk-legacy/overview"| F1
        L2 -->|"/sdk-legacy/overview"| F1
        L3 -->|"/sdk-legacy/overview"| F1
    end

    style T4 fill:#ff6b6b,color:#fff
    style F1 fill:#ffa94d,color:#fff
    style Orphaned fill:#fff3bf,color:#000
Loading

Last reviewed commit: 6d58668

@@ -166,17 +162,6 @@
]
Copy link

Choose a reason for hiding this comment

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

Orphaned page with live internal links

The sdk-legacy/overview.mdx file is still present in the repository, and three other documentation files contain internal links pointing to /sdk-legacy/overview:

  • glossary.mdx (3 links) – references to "SDK (Legacy)" for payment reference, swap-to-pay, and swap-to-conversion definitions
  • use-cases/welcome.mdx – a card href pointing to /sdk-legacy/overview
  • resources/lifecycle-of-a-request.mdx – a prose link to "SDK (Legacy)"

In Mintlify, pages that are not referenced in the docs.json navigation are typically not built or served. This means removing the tab without also removing these inbound links is likely to produce broken links (404s) for readers who click them.

To fix this, either:

  1. Remove or update the five inbound links in glossary.mdx, use-cases/welcome.mdx, and resources/lifecycle-of-a-request.mdx to point elsewhere (e.g., the legacy docs site https://docs.request.network), and delete sdk-legacy/overview.mdx.
  2. Or, if the page should remain accessible, keep it in the navigation (perhaps under the Resources tab) rather than removing the tab entry entirely.

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