diff --git a/ionic/platform/device/device.ts b/ionic/platform/device/device.ts
index 9da86a734e..d029148d0f 100644
--- a/ionic/platform/device/device.ts
+++ b/ionic/platform/device/device.ts
@@ -4,6 +4,15 @@ import * as util from 'ionic/util';
 import {NativePlugin} from '../plugin';
 
 
+/**
+ * Access information about the underlying device and platform.
+ *
+ * @usage
+ * ```js
+ * let info = Device.getDevice();
+ * // Device sits below
+ * ```
+ */
 @NativePlugin({
   name: 'Device',
   plugins: ['ios', 'android', 'web'],