Skip to content

Add third-party tools integration docs and embed snippet example#4534

Merged
devalog merged 4 commits into
mainfrom
fern/add-third-party-integration-docs
Mar 25, 2026
Merged

Add third-party tools integration docs and embed snippet example#4534
devalog merged 4 commits into
mainfrom
fern/add-third-party-integration-docs

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Mar 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Expands the "Connect other integrations" section on the integrations overview page (fern/products/docs/pages/integrations/overview.mdx) to document the third-party tool integration capabilities of custom JavaScript. Previously, this section was a single sentence linking to the custom JS docs. Now it includes:

  • A renamed heading: "Connect other integrations via custom JavaScript"
  • A description clarifying that custom JS is for tools not natively supported in docs.yml
  • A categorized list of example tools that require custom JS: analytics (Amplitude, Heap, Plausible), session recording (Hotjar, LogRocket, Microsoft Clarity), support/chat (Zendesk, Crisp, Drift), and tag managers (Adobe Launch, Tealium)
  • A Hotjar embed snippet as a concrete code example, with a docs.yml reference
  • A closing link back to the custom JS setup page

Also updates the "Common use cases" list on the custom CSS & JS page (custom-css-js.mdx) to flesh out the cross-reference to the integrations page, with bolded labels and a note that custom JS is for tools not natively supported in docs.yml.

No new pages, components, or features are introduced — this is a content-only update across two existing pages.

Updates since last revision

  • Removed tools that already have native docs.yml analytics support (Google Analytics, Google Tag Manager, Segment, PostHog, FullStory, Intercom, Mixpanel) from the custom JS recommendation lists.
  • Replaced the Google Tag Manager code example with a Hotjar embed snippet, since GTM has native docs.yml support.
  • Updated wording on both pages to clarify that custom JS is specifically for tools Fern doesn't natively support.

Review & Testing Checklist for Human

  • Anchor link change: The heading slug changed from #connect-other-integrations to #connect-other-integrations-via-custom-javascript. Verify no internal pages or external sources link to the old anchor. If so, consider adding a redirect or reverting to the original heading text.
  • Tool list accuracy: Confirm none of the listed tools (Amplitude, Heap, Plausible, Hotjar, LogRocket, Microsoft Clarity, Zendesk, Crisp, Drift, Adobe Launch, Tealium) have native docs.yml support that was missed. Conversely, verify no tools that do require custom JS were left out if they're commonly requested.
  • Cross-reference link: The custom-css-js.mdx page now links to /docs/integrations/overview#connect-other-integrations-via-custom-javascript. Confirm this anchor resolves correctly in the preview.
  • Code example rendering: Verify the Hotjar CodeBlock on the integrations page renders correctly (syntax highlighting, no broken JSX). The snippet uses YOUR_HOTJAR_ID as a placeholder — confirm this is acceptable as a documentation example.
  • Preview rendering: Check both updated pages in the preview deployment to ensure bulleted lists, bold labels, inline code, and CodeBlocks render correctly.

Test plan: Open the preview links for both pages, verify the content displays as expected, and click the cross-reference links in both directions to confirm they resolve.

Notes

  • Vale checks pass with 0 errors and 0 warnings. Two pre-existing suggestions remain (Custom JavaScript heading casing and first-person We — both pre-existing).
  • All inline links use /docs/customization/custom-css-js#custom-javascript, matching the existing link convention.
  • The <Markdown src="/snippets/enterprise-plan.mdx"/> snippet is preserved from the original section.

Link to Devin session: https://app.devin.ai/sessions/03964d70af314ed0bbd0555d1c9cb229

@devin-ai-integration devin-ai-integration Bot requested a review from devalog as a code owner March 25, 2026 13:19
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@fern-api

fern-api Bot commented Mar 25, 2026

Copy link
Copy Markdown
Contributor

Requested by: jon
Slack thread: View conversation

@github-actions

github-actions Bot commented Mar 25, 2026

Copy link
Copy Markdown
Contributor

Co-Authored-By: bot_apk <apk@cognition.ai>
@devin-ai-integration devin-ai-integration Bot changed the title Add third-party tools integration documentation to integrations overview Add third-party tools integration docs and embed snippet example Mar 25, 2026
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXX');

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.

📝 [vale] reported by reviewdog 🐶
[FernStyles.Acronyms] 'GTM' has no definition.

@devalog devalog merged commit a126ea5 into main Mar 25, 2026
2 checks passed
@devalog devalog deleted the fern/add-third-party-integration-docs branch March 25, 2026 16:40
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.

2 participants