diff --git a/docs/api/app.md b/docs/api/app.md
index 75ed937dc4a8..fc31d465f7a9 100644
--- a/docs/api/app.md
+++ b/docs/api/app.md
@@ -116,11 +116,12 @@ the application's dock icon.
 Returns:
 
 * `event` Event
-* `type` String - A string identifying the event. Maps to [`NSUserActivity.activityType`](https://developer.apple.com/library/ios/documentation/Foundation/Reference/NSUserActivity_Class/index.html#//apple_ref/occ/instp/NSUserActivity/activityType).
+* `type` String - A string identifying the activity. Maps to
+  [`NSUserActivity.activityType`][activity-type].
 * `userInfo` Object - Contains app-specific state stored by the activity on
-  another device. Currently only string data is supported.
+  another device.
 
-Emitted during [handoff][handoff] when an activity from a different device wants
+Emitted during [Handoff][handoff] when an activity from a different device wants
 to be resumed. You should call `event.preventDefault()` if you want to handle
 this event.
 
@@ -502,13 +503,12 @@ app.on('ready', function() {
 
 ### `app.setUserActivity(type, userInfo)` _OS X_
 
-* `type` String - Uniquely identifies the activity. It's recommended to use a
-  reverse-DNS string.
+* `type` String - Uniquely identifies the activity. Maps to
+  [`NSUserActivity.activityType`][activity-type].
 * `userInfo` Object - App-specific state to store for use by another device.
-  Currently only string data is supported.
 
 Creates an `NSUserActivity` and sets it as the current activity. The activity
-is eligible for [handoff][handoff] to another device afterward.
+is eligible for [Handoff][handoff] to another device afterward.
 
 ### `app.getCurrentActivityType()` _OS X_
 
@@ -602,3 +602,4 @@ Sets the `image` associated with this dock icon.
 [CFBundleURLTypes]: https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102207-TPXREF115
 [LSCopyDefaultHandlerForURLScheme]: https://developer.apple.com/library/mac/documentation/Carbon/Reference/LaunchServicesReference/#//apple_ref/c/func/LSCopyDefaultHandlerForURLScheme
 [handoff]: https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/Handoff/HandoffFundamentals/HandoffFundamentals.html
+[activity-type]: https://developer.apple.com/library/ios/documentation/Foundation/Reference/NSUserActivity_Class/index.html#//apple_ref/occ/instp/NSUserActivity/activityType