Feat(apple): App hang documentation (#5267)

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
Co-authored-by: Bruno Garcia <bruno@brunogarcia.com>

Author: 3 people

src/includes/getting-started-primer/apple.mdx

@@ -9,7 +9,7 @@
   - C++ exceptions
   - Objective-C exceptions
   - Error messages of fatalError, assert, and precondition
-  - App Hang Detection
+  - [App Hang Detection](/platforms/apple/configuration/app-hangs/)
   - [Out of memory](/platforms/apple/configuration/out-of-memory/)
 - Events [enriched](/platforms/apple/enriching-events/context/) with device data
 - Offline caching when a device is unable to connect; we send a report once we receive another event

src/platforms/apple/common/configuration/app-hangs.mdx

@@ -0,0 +1,55 @@
+---
+title: App Hangs
+sidebar_order: 11
+description: "Learn about how to add app hang detection reporting."
+---
+
+This integration tracks app hangs. This feature is available on iOS, tvOS, macOS, and watchOS.
+
+There are many reasons an app can become unresponsive, from long running code to an infinite loop bug, and this can be frustrating to the end user.
+With app hang tracking, you can detect and fix this problem.
+
+The app hang detection integration has a default timeout of two (2) seconds, which means if the app becomes unresponsive for two seconds, an error event is created.
+The event has the stack trace of all running threads so you can easily detect where the problem occurred.
+
+To use this feature, add this to your code:
+
+```swift {tabTitle:Swift}
+import Sentry
+
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.enableAppHangTracking = true
+}
+```
+
+```objc {tabTitle:Objective-C}
+@import Sentry;
+
+[SentrySDK startWithConfigureOptions:^(SentryOptions *options) {
+    options.dsn = @"___PUBLIC_DSN___";
+    options.enableAppHangTracking = YES;
+}];
+
+```
+
+If you want to change the timeout, you can do so by changing the `appHangTimeoutInterval` option:
+
+```swift {tabTitle:Swift}
+import Sentry
+
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.appHangTimeoutInterval = 1
+}
+```
+
+```objc {tabTitle:Objective-C}
+@import Sentry;
+
+[SentrySDK startWithConfigureOptions:^(SentryOptions *options) {
+    options.dsn = @"___PUBLIC_DSN___";
+    options.appHangTimeoutInterval = 1;
+}];
+
+```

src/wizard/apple/ios.md

@@ -108,5 +108,6 @@ SentrySDK.start { options in
     options.enableFileIOTracking = true
     options.enableCoreDataTracking = true
     options.enableUserInteractionTracing = true
+    options.enableAppHangTracking = true
 }
 ```