diff --git a/doc/index.md b/doc/index.md
index 48c8e5a..0aee1e6 100644
--- a/doc/index.md
+++ b/doc/index.md
@@ -19,9 +19,16 @@
 
 # org.apache.cordova.camera
 
-This plugin provides an API for taking pictures and for choosing images from
+This plugin defines a global `navigator.camera` object, which provides an API for taking pictures and for choosing images from
 the system's image library.
 
+Although the object is attached to the global scoped `navigator`, it is not available until after the `deviceready` event.
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    function onDeviceReady() {
+        console.log(navigator.camera);
+    }
+
 ## Installation
 
     cordova plugin add org.apache.cordova.camera