Repository navigation
docs: generate the iOS SDK 3.x and experimental 4.x references - #1032
Merged
gewenyu99 merged 16 commits intoNov 11, 2026
Merged
Conversation
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This was referenced Nov 5, 2026
gewenyu99
changed the base branch from
feat/markdown-reference-tags
to
feat/markdown-reference-adapter
November 5, 2026 16:43
gewenyu99
changed the title
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>
turnipdabeets
left a comment
turnipdabeets
left a comment
Contributor
There was a problem hiding this comment.
[suggestion] posthog-ios-4.md still says to install with CocoaPods, which 4.0 drops, so it needs regenerating once getting-started is fixed in #1030.
[nit] posthog-ios-3.md and posthog-ios-reference.md are identical apart from the title. Is that what the Strapi sync expects?
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…symbols 3.x and 4.x now mark deprecated APIs and give same-titled overloads one heading. 4.x drops the Swift-obsoleted ObjC bridges, lists captureAi, alias(_:options:) and isFeatureEnabled(_:defaultValue:) under their capabilities, and installs with Swift Package Manager only. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The pages match the tag-based run, minus six empty Discussion headings that a discussion holding only the tag line left behind. 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>
6 of 18 tasks
Contributor
Author
|
Good catch on CocoaPods. It's dropped in 4.0 and the getting started is rewritten. |
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
| The distinct ID can come from `identify(_:)`, the `distinctId` argument of `capture` or `beforeSend`. | ||
| 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. | ||
|
|
||
| ### SDK identity |
Contributor
There was a problem hiding this comment.
Contributor
Author
There was a problem hiding this comment.
Yes, we'll regenerate once that merges, but I'll go ahead and regenerate now from that branch. It also regenerates on every release, so any minor drift gets picked up then. Thanks!
Rebuilt from MIGRATION.md on chore/v4-remove-deprecated, which dropped the SDK identity section (#1036) and added the isFeatureEnabled empty-variant note. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Rebuilt from MIGRATION.md on chore/v4-remove-deprecated after its pre-release review fixes. 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>
… into feat/markdown-reference-3
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PR overviewNo security issues were found in this pull request. Reviews
|
turnipdabeets
approved these changes
Nov 10, 2026
3 of 6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
💡 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 #1030.
references/posthog-ios-3.mdand the latest page,posthog-ios-reference.md.posthog-ios-4.mdandposthog-ios-migration.md, generated fromchore/v4-remove-deprecated, the 4.0 branch in chore!: iOS Major Release 4.0 #873. The Swift Package Manager getting-started needs to land there before that page can be regenerated there.posthog-ios-migration.mdis regenerated fromMIGRATION.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