diff --git a/src/deserializer-manager.coffee b/src/deserializer-manager.coffee
index 60df24b0a..e42beb14f 100644
--- a/src/deserializer-manager.coffee
+++ b/src/deserializer-manager.coffee
@@ -1,6 +1,17 @@
 # Public: Manages the deserializers used for serialized state
 #
-# Should be accessed via `atom.deserializers`
+# An instance of this class is always available as the `atom.deserializers`
+# global.
+#
+# ### Registering a deserializer
+#
+# ```coffee
+# class MyPackageView extends View
+#   atom.deserializers.add(this)
+#
+#   @deserialize: (state) ->
+#     new MyPackageView(state)
+# ```
 module.exports =
 class DeserializerManager
   constructor: (@environment) ->