docs: add distribution channels and workflow to RELEASE.md - #8681
Open
itaybre wants to merge 1 commit into
Open
Conversation
Document current release targets (SPM, Carthage, downstream repos via Craft), note CocoaPods removal, and outline the release workflow steps including XCFramework assembly, archive creation, and Craft publishing.
itaybre
requested review from
NinjaLikesCheez,
noahsmartin,
philipphofmann and
philprime
as code owners
August 4, 2026 20:41
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
| | `getsentry/sentry-apple-swiftybeaver` | 3rd-party integration mirror | | ||
| | Sentry Release Registry | Updates the `cocoapods:sentry-cocoa` entry (historical name) | | ||
|
|
||
| The 3rd-party integration repos also receive continuous code sync on every push to `main`. See [MIRRORING.md](MIRRORING.md) for full details on both mechanisms. |
There was a problem hiding this comment.
Bug: The RELEASE.md file contains a broken link to MIRRORING.md, which does not exist in the repository.
Severity: LOW
Suggested Fix
Either create the missing MIRRORING.md file with the relevant documentation content or remove the broken link from develop-docs/RELEASE.md if the documentation is not available.
Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.
Location: develop-docs/RELEASE.md#L25
Potential issue: The documentation file `develop-docs/RELEASE.md` at line 25 contains a
relative link to `MIRRORING.md`. However, this file does not exist anywhere in the
repository. When a user clicks this link in the rendered Markdown, they will encounter a
404 error page instead of the intended documentation about code mirroring mechanisms.
This is a documentation integrity issue.
Did we get this right? 👍 / 👎 to inform future reviews.
itaybre
added
the
run-full-ci
NinjaLikesCheez
approved these changes
Aug 5, 2026
NinjaLikesCheez
left a comment
NinjaLikesCheez
left a comment
Member
There was a problem hiding this comment.
LGTM, 2 small suggestions for you to consider.
|
|
||
| ## Distribution Channels | ||
|
|
||
| The SDK is distributed via **SPM**. CocoaPods and Carthage support were removed. |
Member
There was a problem hiding this comment.
Suggested change
| The SDK is distributed via **SPM**. CocoaPods and Carthage support were removed. | |
| The SDK is distributed via **SPM**. CocoaPods and Carthage support has been removed. |
Comment on lines
+17
to
+22
| | GitHub Release | Source + XCFramework zips on the [releases page](https://github.com/getsentry/sentry-cocoa/releases/) | | ||
| | `getsentry/sentry-apple-binaries` | Pre-built XCFrameworks with a `Package.swift` for SPM binary targets | | ||
| | `getsentry/sentry-apple-swift-log` | 3rd-party integration mirror | | ||
| | `getsentry/sentry-apple-cocoalumberjack` | 3rd-party integration mirror | | ||
| | `getsentry/sentry-apple-pulse` | 3rd-party integration mirror | | ||
| | `getsentry/sentry-apple-swiftybeaver` | 3rd-party integration mirror | |
Member
There was a problem hiding this comment.
Suggested change
| | GitHub Release | Source + XCFramework zips on the [releases page](https://github.com/getsentry/sentry-cocoa/releases/) | | |
| | `getsentry/sentry-apple-binaries` | Pre-built XCFrameworks with a `Package.swift` for SPM binary targets | | |
| | `getsentry/sentry-apple-swift-log` | 3rd-party integration mirror | | |
| | `getsentry/sentry-apple-cocoalumberjack` | 3rd-party integration mirror | | |
| | `getsentry/sentry-apple-pulse` | 3rd-party integration mirror | | |
| | `getsentry/sentry-apple-swiftybeaver` | 3rd-party integration mirror | | |
| | GitHub Release | Source + XCFramework zips on the [releases page](https://github.com/getsentry/sentry-cocoa/releases/) | | |
| | [`getsentry/sentry-apple-binaries`](https://github.com/getsentry/sentry-apple-binaries) | Pre-built XCFrameworks with a `Package.swift` for SPM binary targets | | |
| | [`getsentry/sentry-apple-swift-log`](https://github.com/getsentry/sentry-apple-log) | 3rd-party integration mirror | | |
| | [`getsentry/sentry-apple-cocoalumberjack`](https://github.com/getsentry/sentry-apple-cocoalumberjack) | 3rd-party integration mirror | | |
| | [`getsentry/sentry-apple-pulse`](https://github.com/getsentry/sentry-apple-pulse) | 3rd-party integration mirror | | |
| | [`getsentry/sentry-apple-swiftybeaver`](https://github.com/getsentry/sentry-apple-swiftybeaver] | 3rd-party integration mirror | |
Just to make life easier for future me when I need/want to click these heh
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
3 participants
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.
Description
Add a "Distribution Channels" section to
develop-docs/RELEASE.mddocumenting:MIRRORING.mdfor continuous sync details#skip-changelog
Closes #8682