[docs] Updating README

README.md

@@ -18,7 +18,21 @@ Through the removal of this boilerplate code, restful creates a robust, standard
 
 # Usage
 
-## As a Flatiron Plugin
+## Define resource(s)
+
+```js
+
+var resourceful = require('resourceful'),
+    Creature    = resourceful.define('creature');
+
+Creature.property('type', String, { default: "dragon" });
+Creature.property('life', Number, { default: 10, min: 0, max: 20 });
+
+```
+
+*[additional API documentation for defining resources](http://github.com/flatiron/resourceful)*
+
+## As a Flatiron plugin
 
 To use restful as a <a href="http://github.com/flatiron/flatiron">Flatiron</a> plugin you will have to: