Improve README for better clarity.

README.md

@@ -1,7 +1,7 @@
 mongoose-lifecycle
 ==================
 
-Mongoose plugin adding lifecyle events on the model class.
+[Mongoose](https://github.com/LearnBoost/mongoose) plugin adding lifecyle events to the model class.
 
 Installation
 ------------
@@ -30,6 +30,7 @@ Initialization is straightforward:
 ```javascript
 var Book = new Schema({ ... });
 Book.plugin(require('mongoose-lifecycle'));
+module.exports = mongoose.model('Book', Book);
 ```
 
 Now the model emits lifecycle events before and after persistence operations:
@@ -48,10 +49,47 @@ You can listen to these events directly on the model.
 ```javascript
 var Book = require('path/to/models/book');
 Book.on('beforeInsert', function(book) {
-  // do stuff...
+  console.log('A new book "%s" was inserted', book.title);
 });
 ```
 
+The `beforeInsert` event is emitted just before a new document is persisted:
+
+```javascript
+var book = new Book();
+book.title = 'War and Peace';
+book.save(); // logs the book title to the console
+});
+```
+
+Why Not Use The `save` and `remove` events?
+-------------------------------------------
+
+Because you may not have access to the right class to register them.
+
+```javascript
+// if you register an event listener on the Schema class, it works
+// in models/book.js
+var Book = new Schema({ ... });
+Book.pre('save', function(next) {
+  console.log('A new book "%s" was inserted', this.title);
+  next();
+});
+
+// if you register an event listener on the Model class, it doesn't work
+// in models/book.js
+var Book = new Schema({ ... });
+module.exports = mongoose.model('Book', Book);
+// in a controller class
+var Book = require('path/to/models/book'); // Book is a Model, not a Schema
+Book.pre('save', function(next) {
+  console.log('A new book "%s" was inserted', this.title);
+  next();
+});
+```
+
+The plugin does the work of finding the Schema back from the Model class. It also allows you to use the standard `on()` method to register event listeners, instead of the custom `pre()` and `post()` Mongoose methods. Lastly, it makes a difference between insert and update persistence operations, while Mongoose only provides a `save` event.
+
 License
 -------
 

package.json

@@ -10,8 +10,7 @@
   },
   "devDependencies": {
     "should": ">=0.2.1",
-    "mongoose": ">=2.6.5",
-    "cli-table" : ">=0.0.1"
+    "mongoose": ">=2.6.5"
   },
   "license": "MIT",
   "engine": {