Skip to content

Am/cus 289/remove slack ctas from turnkey docs - #772

Open
am-hernandez wants to merge 3 commits into
mainfrom
am/CUS-289/remove-slack-ctas-from-turnkey-docs
Open

Am/cus 289/remove slack ctas from turnkey docs#772
am-hernandez wants to merge 3 commits into
mainfrom
am/CUS-289/remove-slack-ctas-from-turnkey-docs

Conversation

@am-hernandez

Copy link
Copy Markdown
Contributor

docs(support): add a Support page and remove Slack CTAs

Why

Turnkey Docs still pointed developers to the public Club Turnkey Slack community as a support channel. Pylon is the support surface now, so those CTAs needed to go and the docs needed a single page describing how to actually get help.

What

New Support page (solutions/support/overview.mdx, added to the Solutions nav):

  • Covers the in-dashboard support chat: where the launcher is, what the panel does (new conversations, past conversations, its GitHub / status page / Contact Sales bookmarks), and how the AI first response escalates to the team.
  • Notes the two prerequisites: current dashboard only, and you must be logged in.
  • Documents email routing (help@turnkey.com for support, hello@turnkey.com for commercial), the Enterprise shared Slack channel, X, and the status page.
  • Adds a "what to include in a support request" checklist plus a warning never to share key material.
  • Four screenshots in assets/files/: launcher location, both dashboard Support CTAs, and two captioned shots of the open panel.

CTA cleanup (docs.json):

  • Navbar Support link now points at /solutions/support/overview instead of the Slack invite.
  • Footer slack social removed with no replacement.

Reusable callout (snippets/support-callout.mdx), replacing 18 Slack/hello@turnkey.com sign-offs across 17 files:

  • SupportCallout takes an optional prompt and renders the shared "reach out through any of our support channels" sentence. It returns a fragment rather than a <Note>, so it drops into a paragraph, a list item, or an accordion without changing the visual weight of the copy it replaces.
  • SupportLink is the inline anchor, for the two cases that live inside bullet lists.
  • 14 network pages, reference/faq.mdx (2), features/authentication/passkeys/integration.mdx, and solutions/cookbooks/tron-gasless-transactions.mdx.

Scope and non-goals

  • features/networks/others.mdx carried the same sign-off as unlinked plain text, so the ticket's URL grep missed it. It is fixed here, which makes 14 network pages rather than the 13 the ticket lists.
  • Shared/dedicated Slack channel references are intentionally kept in tvc-beta-callout.mdx, time-based-policies-beta-callout.mdx, verifiable-cloud/onboarding.mdx, and manifest-sets-and-share-sets.mdx. Those are the Enterprise shared channel, not the community.
  • Context-specific hello@turnkey.com asks are left alone, since they are not multi-channel support sign-offs: bespoke email templates, Python SDK prioritization, wallets.mdx, faq.mdx (2), migration-guide.mdx, and the help@turnkey.com guidance in api-reference/overview/errors.mdx, though they may warrant a folloew-up.

Testing

Verified locally: the page renders, all four screenshots resolve, and every internal link in it points at a real page (/reference/faq, /api-reference/overview/errors, /api-reference/overview/intro, /sdks/introduction).

Reviewers should check:

  • The SupportCallout fragment renders inline correctly in all three positions, especially inside the FAQ accordions.
  • The navbar Support link stays on localhost under mintlify dev.
  • Copy accuracy on the Pylon behavior, particularly the escalation description and the launcher position.
  • Consider IA and if the location of the Support doc is ideal.

Ticket

Closes CUS-289

@mintlify

mintlify Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
turnkey-docs 🟢 Ready View Preview Aug 11, 2026, 10:21 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@radusandor radusandor left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reviewed the full diff and the preview deploy. This looks great, everything checks out:

  • SupportCallout / SupportLink in all three positions(accordion, list item, paragraph) all render correctly.

  • Navbar link: hovered the navbar Support link on the preview deploy; it resolves origin-relative (…mintlify.site/solutions/support/overview) rather than jumping to docs.turnkey.com, so the relative href behaves.

Holding off on approval only until the Club Turnkey question is settled.

in-depth, ongoing integration support can ask about upgrading to an Enterprise
plan here.

## Shared Slack channel

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

More of an open question for everybody:
should we keep a pointer to the Club Turnkey community Slack here while it's still live? After this PR the invite is gone from every surface in docs, navbar, footer social, and all 18 sign-offs, so there's no path to it at all.

Not arguing against Pylon being the primary channel, asking whether a short "Community" section (clearly marked as not the support channel) is worth keeping until we formally deprecate Club Turnkey. If it's being shut down soon, removing it now is right and we can ignore this. But if we're are going to keep it live for some more time, I think we should still let users know about it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I lean towards keeping the Shared Slack channel present in at least one path (just less advertised) rather than removing it outright. Once we've had enough usage of Pylon and can confirm it's in a good place, then we can fully deprecate. Also think it is worth noting the point from our last meeting that we'd lose a place to blast announcements, so a gradual removal would be a bit softer for that use case too.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I think for now we remove the invites and can consider the community addition for Github in a followup.

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