Repository navigation
docs: generate the Android SDK 3.x and experimental 4.x references - #940
Conversation
Generated by bin/docs_scripts/generate_markdown.py. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The 4.x page and migration guide come from chore/v4-remove-deprecated (the 4.0 branch) with the capability tags and getting-started applied. Both still need to land there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The 3.x pages lose only the blank line the stripped capability tags left behind. The 4.x page also moves captureAi to Capture AI and onFeatureFlags to On feature flags, which the map's "next" entries add. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
| @@ -0,0 +1,2569 @@ | |||
| --- | |||
| title: "PostHog Android SDK 4.x (experimental)" | |||
There was a problem hiding this comment.
[suggestion] Once this is on main, the daily sync publishes it and posthog-android-migration.md on posthog.com while 4.0 is still unreleased. Nothing regenerates them until the 4.0 release, and they're already behind the v4 branch (e.g. the remoteConfig removal). Could we drop both from this PR and generate them on #871's branch once #939 is merged into it?
There was a problem hiding this comment.
Yes, those pages on posthog.com don't go live yet. The pages are going to go up first unindexed, and not in navigation. And we won't merge these PRs either until the SDK is actually released.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
| If you identify users with a long ID, such as a JWT or a long email address, shorten or hash it before you upgrade. Otherwise every event for that user is dropped. | ||
| `identify()` with an empty or whitespace-only distinct ID is still ignored, as in 3.x. | ||
|
|
||
| ## SDK identity |
There was a problem hiding this comment.
[suggestion] This page is behind docs/migration-3.x-to-4.0.md on chore/v4-remove-deprecated: the branch dropped this SDK identity section (#942 keeps $lib in properties) and added the custom httpClient paragraph, which is missing here. Could we regenerate from the current branch, or once #871 merges?
There was a problem hiding this comment.
Yes, I'll regenerate now from that branch, and again once it merges. It also regenerates on every release, so any minor drift gets picked up then. Thanks!
Rebuilt from docs/migration-3.x-to-4.0.md on chore/v4-remove-deprecated, which dropped the SDK identity section (#942) and added the custom httpClient paragraph. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Rebuilt from docs/migration-3.x-to-4.0.md on chore/v4-remove-deprecated, which now covers the missing-flag response, posthog-server 2.25 and retry scope. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Picks up the branch's feature flag doc comment fixes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… markdown-reference-pages-3
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PR overviewNo security issues were found in this pull request. Reviews
|
💡 Motivation and Context
We have a wave of breaking changes with new major versions for most SDKs. References are now read mostly by bots, not humans, and the HogRef format is heavy. Stacked on #939.
references/posthog-android-3.mdand the latest page,posthog-android-reference.md.posthog-android-4.mdandposthog-android-migration.md, generated fromchore/v4-remove-deprecated, the 4.0 branch in feat!: posthog-android 4.0 and posthog 7.0 #871. The getting-started and a few field docs need to land there before that page can be regenerated there.posthog-android-migration.mdis regenerated fromdocs/migration-3.x-to-4.0.mdonchore/v4-remove-deprecated.💚 How did you test it?
📝 Checklist
🤖 Agent context
Autonomy: Human-driven (agent-assisted)
Claude Code: Sonnet 5.5 built it and Opus 5.5 opened it, directed by Vincent. Not yet reviewed line by line.
End result
This is what we're building toward: the reference page on posthog.com, rendered from this PR's Markdown in a local posthog.com build with a local Strapi.
Merge order
🤖 Generated with Claude Code