Am/cus 289/remove slack ctas from turnkey docs - #772
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
radusandor
left a comment
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
I think for now we remove the invites and can consider the community addition for Github in a followup.
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):help@turnkey.comfor support,hello@turnkey.comfor commercial), the Enterprise shared Slack channel, X, and the status page.assets/files/: launcher location, both dashboard Support CTAs, and two captioned shots of the open panel.CTA cleanup (
docs.json):/solutions/support/overviewinstead of the Slack invite.slacksocial removed with no replacement.Reusable callout (
snippets/support-callout.mdx), replacing 18 Slack/hello@turnkey.comsign-offs across 17 files:SupportCallouttakes an optionalpromptand 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.SupportLinkis the inline anchor, for the two cases that live inside bullet lists.reference/faq.mdx(2),features/authentication/passkeys/integration.mdx, andsolutions/cookbooks/tron-gasless-transactions.mdx.Scope and non-goals
features/networks/others.mdxcarried 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.tvc-beta-callout.mdx,time-based-policies-beta-callout.mdx,verifiable-cloud/onboarding.mdx, andmanifest-sets-and-share-sets.mdx. Those are the Enterprise shared channel, not the community.hello@turnkey.comasks 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 thehelp@turnkey.comguidance inapi-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:
SupportCalloutfragment renders inline correctly in all three positions, especially inside the FAQ accordions.mintlify dev.Ticket
Closes CUS-289