diff --git a/README.md b/README.md
index b254d946..a6e7c7f3 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,11 @@
 ## About [<img src="https://secure.travis-ci.org/1602/jugglingdb.png" />](http://travis-ci.org/#!/1602/jugglingdb)
 
-JugglingDB is cross-db ORM for nodejs, providing **common interface** to access
-most popular database formats.  Currently supported are: mysql, sqlite3,
-postgres, couchdb, mongodb, redis, neo4j and js-memory-storage (yep,
-self-written engine for test-usage only). You can add your favorite database
-adapter, checkout one of the existing adapters to learn how, it's super-easy, I
-guarantee.
+[JugglingDB(3)](http://jugglingdb.co) is cross-db ORM for nodejs, providing
+**common interface** to access most popular database formats.  Currently
+supported are: mysql, sqlite3, postgres, couchdb, mongodb, redis, neo4j and
+js-memory-storage (yep, self-written engine for test-usage only). You can add
+your favorite database adapter, checkout one of the existing adapters to learn
+how, it's super-easy, I guarantee.
 
 Jugglingdb also works on client-side (using WebService and Memory adapters),
 which allows to write rich client-side apps talking to server using JSON API.
@@ -257,9 +257,9 @@ user.save(callback);
 // afterSave
 // callback
 user.updateAttribute('email', 'email@example.com', callback);
+// beforeUpdate
 // beforeValidation
 // afterValidation
-// beforeUpdate
 // afterUpdate
 // callback
 user.destroy(callback);
@@ -275,7 +275,7 @@ User.create(data, callback);
 ```
 
 Read the tests for usage examples: ./test/common_test.js
-Validations: ./test/validations_test.js
+Validations: ./test/validations.test.js
 
 ## Your own database adapter
 
diff --git a/docs/changelog.md b/docs/changelog.md
index b8d4c29a..206c88e2 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -3,9 +3,15 @@ jugglingdb-changelog(3) - The History of JugglingDB
 
 ## HISTORY
 
-### upcoming release
+### upcoming release 0.3.0
 
-* Documentation in [web][http://jugglingdb.co] and man
+* Documentation:
+  Available in [web](http://jugglingdb.co) and man [jugglingdb(3)]
+
+* **Hooks**:
+  Changed format of update and save hooks. Hook accept data as second argument.
+  This data could be modified and it will be saved to database after hook done.
+  **NOTE**: this change could break some code.
 
 ### 0.2.1
 
@@ -70,3 +76,7 @@ jugglingdb-changelog(3) - The History of JugglingDB
 ### 0.0.1
 
 Package extracted from [RailwayJS MVC](http://railwayjs.com)
+
+## SEE ALSO
+
+jugglingdb-roadmap(3)