docs(apple): Add replay overmask troubleshooting

[philprime]

DESCRIBE YOUR PR

Add troubleshooting guidance for Session Replay regions that become completely masked when Core Animation raises during layer traversal.

The entry explains the privacy-safe fallback, identifies mismatched CABasicAnimation endpoint types as a possible cause, provides incorrect and corrected Swift examples, and shows the related SDK warning. This documents the behavior introduced by getsentry/sentry-cocoa#8537.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

• 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

Make sure you've checked the following before merging your changes:

• 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

EXTRA RESOURCES

• Sentry Docs contributor guide

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
sentry-docs	Ready	Preview	Jul 29, 2026 11:38am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ignored		Jul 29, 2026 11:38am