diff --git a/ionic/platform/device-motion/device-motion.ts b/ionic/platform/device-motion/device-motion.ts
index 496dd5d96f..81ae548405 100644
--- a/ionic/platform/device-motion/device-motion.ts
+++ b/ionic/platform/device-motion/device-motion.ts
@@ -17,7 +17,7 @@ import {NativePlugin} from '../plugin';
  * })
  *
  * watch.clear() // to stop watching
- ```
+ * ```
  */
 @NativePlugin({
   name: 'Device Motion',
diff --git a/ionic/platform/device-orientation/device-orientation.ts b/ionic/platform/device-orientation/device-orientation.ts
index bb294eb118..f87796a5e1 100644
--- a/ionic/platform/device-orientation/device-orientation.ts
+++ b/ionic/platform/device-orientation/device-orientation.ts
@@ -4,6 +4,19 @@ import * as util from 'ionic/util';
 import {NativePlugin} from '../plugin';
 
 
+/**
+ * Respond to device orientation changes (compass).
+ *
+ * @usage
+ * ```js
+ * let watch = DeviceOrientation.watchHeading();
+ * watch.source.subscribe((data) => {
+ *  // data.alpha is the compass heading
+ * })
+ *
+ * watch.clear() // to stop watching
+ * ```
+ */
 @NativePlugin({
   name: 'Device Orientation',
   platforms: ['ios', 'android', 'web'],