Skip to content

docs: say the SDKs are open source on every SDK page - #291

Open
tylergoerzen-mxp wants to merge 2 commits into
mainfrom
tylergoerzen/tof-685-open-source-sdks
Open

tylergoerzen-mxp wants to merge 2 commits into
mainfrom
tylergoerzen/tof-685-open-source-sdks

Conversation

@tylergoerzen-mxp

Copy link
Copy Markdown
Contributor

Why

Agents keep calling Mixpanel "closed source." In our AEO tracker's coding runs, 34 of 66 agent explanations for passing on Mixpanel cite PostHog being open source. That's wrong for our SDKs, which are all Apache 2.0 or MIT. But nothing tells agents that: no SDK page or llms.txt mentions open source, and mixpanel.com/open-source 404s.

What changed

  • Added one line to each of the 13 SDK pages (Javascript, React Native, Android, iOS Objective-C, iOS Swift, Flutter, Unity, Python, Node.js, Ruby, PHP, Go, Java). It sits under Getting Started, right after the existing "documented in our GitHub repo" sentence, and names the license (linked to the repo's LICENSE file) and the repo.
  • New page docs/tracking-methods/sdks/open-source.mdx, "Open Source at Mixpanel." It has a SDK | Repository | License table for all 13 SDKs, the 5 Session Replay SDKs, and mixpanel-utils. It also says plainly that Mixpanel's platform is a hosted service and isn't open source.
  • Added the page to the SDKs group in docs.json and linked it from the SDKs overview (docs/tracking-methods/sdks.mdx).
  • llms.txt: no source or config for it exists in this repo, so Mintlify auto-generates it. The new page has a description, so it should show up there after deploy. Nothing to edit here.

How facts were verified

  • Every repo checked with gh repo view mixpanel/<repo> --json name,licenseInfo,url,isArchived on 2026-10-02. All are public and none are archived.
  • GitHub detects Apache 2.0 for js, react-native, android, iphone, swift, flutter, unity, go, ios-session-replay-package, and flutter-session-replay. It detects MIT for node and react-native-session-replay.
  • GitHub shows "Other" for python, ruby, php, java, and utils. I decoded each LICENSE file with gh api repos/mixpanel/<repo>/license, and all five are the Apache License 2.0 text. The table links each license file directly so readers can check.
  • Session Replay for Javascript and Android ships inside mixpanel-js (src/recorder) and mixpanel-android (session-replay/ module), which matches the 2026-05-11 changelog.
  • Every license link uses the html_url the GitHub license API returned, so branch names (master vs main) and filenames (LICENSE, LICENSE.md, LICENSE.txt) are exact.

Checks

  • python scripts/check_frontmatter.py, check_code_samples.py, check_links.py, check_redirects.py: all pass
  • npx mint broken-links: no broken links found
  • docs.json parses as valid JSON

Linear: TOF-685

🤖 Generated with Claude Code

Add a one-line license + repo statement to each of the 13 SDK pages,
add an "Open Source at Mixpanel" page listing every SDK's repository
and license, link it from the SDKs overview, and add it to the nav.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
mixpanel-docs 🟢 Ready View Preview Oct 2, 2026, 9:40 PM

@linear-code

linear-code Bot commented Oct 2, 2026

Copy link
Copy Markdown

TOF-685

@greptile-apps

greptile-apps Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 5/5

[Low risk] Adds open source license information to SDK documentation.

The PR appears safe to merge.

Reviews (2) · Last reviewed commit: "Say license text is linked instead of na..."

Comment thread docs/tracking-methods/sdks/open-source.mdx Outdated
Two repos use LICENSE.md and LICENSE.txt, so 'its LICENSE file' was wrong for them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@greptile-apps

greptile-apps Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

Want your agent to iterate on Greptile's feedback? Try greploops.

This branch was successfully deployed

1 active deployment
staging — 8972c6f7 Deployed Oct 2, 2026 by mintlify[bot]
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