Skip to content

docs(apple): Add missing experimental options and remove experimental-features page#17987

Open
philprime wants to merge 2 commits into
masterfrom
philprime/apple-experimental-features
Open

docs(apple): Add missing experimental options and remove experimental-features page#17987
philprime wants to merge 2 commits into
masterfrom
philprime/apple-experimental-features

Conversation

@philprime
Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Add missing <SdkOption> entries for experimental.enableUnhandledCPPExceptionsV2 and experimental.enableWatchdogTerminationsV2 to the Apple SDK options reference.

Remove the standalone experimental-features.mdx page since all its content is now covered in options.mdx or on the pages it linked to (some of which were broken links to features removed in SDK 9.0.0).

  • Add experimental.enableUnhandledCPPExceptionsV2 option to options.mdx
  • Add experimental.enableWatchdogTerminationsV2 option to options.mdx
  • Delete docs/platforms/apple/common/features/experimental-features.mdx
  • Remove references to the deleted page from features index pages (common, macOS, visionOS)

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

…-features page

Add SdkOption entries for experimental.enableUnhandledCPPExceptionsV2 and
experimental.enableWatchdogTerminationsV2 to the options reference.

Remove the standalone experimental-features page since all its content
is now covered in options.mdx or linked target pages. Remove references
from features index pages for common, macOS, and visionOS.
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Jun 2, 2026 3:26pm
sentry-docs Ready Ready Preview, Comment Jun 2, 2026 3:26pm

Request Review

@codeowner-assignment codeowner-assignment Bot requested a review from a team June 2, 2026 14:57
@@ -83,10 +83,6 @@ All features listed below are **enabled by default** unless otherwise noted. Som
- Offline caching when a device is unable to connect; we send a report once we receive another event
- Event persistence: crash reports persist to disk and are sent upon application start if not sent immediately after a crash

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.

Bug: The static file public/_platforms/apple/ios.json is not regenerated and contains stale references to the deleted experimental-features page, which may cause issues for consuming systems.
Severity: LOW

Suggested Fix

Manually update the public/_platforms/apple/ios.json file to remove all references to the deleted experimental-features page. Alternatively, confirm with the relevant team whether this file is still in use. If it is deprecated, consider removing it entirely.

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: docs/platforms/apple/common/features/index.mdx#L85

Potential issue: The build process does not automatically regenerate the
`public/_platforms/apple/ios.json` file. This static, checked-in file contains stale
references and HTML content related to a now-deleted `experimental-features` page.
According to documentation, this file may be consumed by an external utility in the main
Sentry repository. If that utility is still in use and attempts to process the stale
links from this JSON, it could lead to broken links or other failures in the integration
documentation system.

Also affects:

  • docs/platforms/apple/guides/macos/features/index.mdx:92~92
  • docs/platforms/apple/guides/visionos/features/index.mdx:71~71

Did we get this right? 👍 / 👎 to inform future reviews.

…s.json

The static _platforms/apple/ios.json still contained the old experimental
features content that was removed from the live docs in 6e63335.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant