diff --git a/js/utils/keyboard.js b/js/utils/keyboard.js
index e1b140466b..5be1dc5c6c 100644
--- a/js/utils/keyboard.js
+++ b/js/utils/keyboard.js
@@ -29,8 +29,13 @@
  * - If your app is running in fullscreen, i.e. you have `<preference name="Fullscreen" value="true" />` in your `config.xml` file
  * you will need to set `ionic.Platform.isFullScreen = true` manually.
  *
- * - If you are not using the keyboard plugin, it may be necessary to set `android:windowSoftInputMode="adjustResize"` to
- * your activity in `AndroidManifest.xml` to get things working properly.
+ * - You can configure the behavior of the web view when the keyboard shows by setting 
+ *   [android:windowSoftInputMode](http://developer.android.com/reference/android/R.attr.html#windowSoftInputMode) to either `adjustPan`, `adjustResize` or `adjustNothing` in your app's activity in `AndroidManifest.xml`. `adjustResize` is the recommended setting for Ionic, but if for some reason you do use `adjustPan` you will need to set `ionic.Platform.isFullScreen = true`.
+ *
+ *   ```xml
+ *   <activity android:windowSoftInputMode="adjustResize">
+ *
+ *   ```
  *
  * ### iOS Notes
  * - if you are not using the keyboard plugin, switching to inputs below the keyboard using the accessory bar will automatically use the native browser's