Skip to content

docs: remove Legacy Dashboard instructions - #862

Merged
Manny-r31 merged 9 commits into
mainfrom
manny/remove-legacy-dashboard-notes
Nov 6, 2026
Merged

Manny-r31 merged 9 commits into
mainfrom
manny/remove-legacy-dashboard-notes

Conversation

@Manny-r31

Copy link
Copy Markdown
Collaborator

Summary

Every Space is on the current Dashboard, so the Legacy Dashboard instructions and "which Dashboard am I on?" notes no longer apply.

  • SIP trunking: removed the trailing "In the Legacy Dashboard" section.
  • SWML remote server guide: removed the "No Resources tab?" note and the legacy accordion.
  • SWML quickstart: removed the legacy instructions and the Dashboard migration accordion after the steps.
  • Receiving your first SMS (cXML): removed the trailing "In the Legacy Dashboard" section.
  • Gathering user input (cXML): replaced the New/Legacy Dashboard tabs with the current steps: My Resources > + Add > Script > cXML Script.
  • Deleted the four snippets that only served the legacy notes (add-resource-legacy-warning, legacy-instructions, _ui-accordion, create-cxml-script) and the five images that only those sections used.

Notes for reviewers

  • The Resources page's legacy note is removed in docs(platform): rewrite Resources and Addresses pages #752, not here, to keep that page's changes in one PR.
  • Callback for inbound fax (/docs/compatibility-api/guides/callback-for-inbound-fax) still uses the legacy cXML Bins screen for its only setup steps, so removing them would leave the guide without instructions. It needs a rewrite for the current Dashboard and is left for a follow-up. dashboard/legacy/xml-bins.webp stays until then.

Verification

  • yarn fern-md-check: all MDX files valid.
  • No remaining references to the deleted snippets or images.
  • No inbound links to the removed #legacy-dashboard anchor.

Pages changed

  • /docs/platform/voice/sip/trunking
  • /docs/swml/guides/remote-server
  • /docs/swml/guides
  • /docs/compatibility-api/guides/receive-sms
  • /docs/compatibility-api/guides/gather-user-input

🤖 Generated with Claude Code

Every Space is on the current Dashboard. Remove the legacy sections and
Dashboard-version notes from the SIP trunking, SWML, and cXML guides,
replace the cXML Script tabs with the current steps, and delete the
snippets and images only those sections used.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hey-august
hey-august self-requested a review October 28, 2026 12:33

@hey-august hey-august left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

The removals look good, and nothing still references the deleted snippets, images, or the #legacy-dashboard anchor. Two pages still have Legacy Dashboard content:

  1. compatibility-api/pages/cxml/guides/securing-callback-for-inbound-fax.mdx (lines 26–39): This page is still written for the Legacy Dashboard. It points to cXML/LaML > Bins, shows legacy/xml-bins.webp, and its llms-only text says "In the legacy Dashboard…". Please rewrite it to the My Resources > + Add > Script > cXML Script flow, as done in gathering-user-input.mdx.
  2. platform/pages/platform/call-fabric/resources.mdx (lines 123–127): The "No Resources tab?" callout about the Legacy Dashboard is the same kind of note this PR removes from swml_remote_server.mdx. Please remove it as well.

hey-august and others added 2 commits October 28, 2026 08:39
Rewrite the inbound fax callback guide's Dashboard steps for the current
flow (My Resources > + Add > Script > cXML Script, then assign it as the
number's call handler), delete the now-unused legacy xml-bins image, and
remove the "No Resources tab?" Legacy Dashboard callout from Resources.
@github-actions

github-actions Bot commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

@Devon-White

Copy link
Copy Markdown
Collaborator

Thanks, both addressed in 3ae4569:

  1. Inbound fax page: rewritten for the My Resources > + Add > Script > cXML Script flow, worded the same as gathering-user-input.mdx. It then assigns the script with the shared assign-resource snippet. I dropped the "Accept Incoming Calls As: Fax" step: the current Dashboard always assigns a Resource as a voice handler, and <Receive> answers and receives the fax on its own. The legacy xml-bins.webp had no other references, so it's deleted.
  2. Resources page: the "No Resources tab?" Legacy Dashboard callout is gone.

@hey-august hey-august left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks, Devon. Both items are addressed in 3ae4569. I confirmed that <Receive> answers and receives the fax whatever the number's call type is (mod_laml.c parse_Receive), so dropping the fax-mode step is correct.

One small correction to the comment above: assignment isn't always a voice handler. A cXML Script created with Call Type: Faxing switches the number to fax on assignment (prime-rails Fabric::PhoneRoutes::SetCallHandlerFromResource). Either way the guide works as written.

@Manny-r31
Manny-r31 merged commit 561047d into main Nov 6, 2026
2 checks passed
@Manny-r31
Manny-r31 deleted the manny/remove-legacy-dashboard-notes branch November 6, 2026 12:39
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