sample added

README.md

@@ -3,6 +3,24 @@ entitlement(1) -- abstractions around roles rights and entitlements
 
 [![Build Status](https://secure.travis-ci.org/arlac77/entitlement.png)](http://travis-ci.org/arlac77/entitlement)
 
+
+	entitlement       = require('entitlement');
+
+	entitlement.registerRoles({
+		"view" : ['types.read','values.read'],
+		"edit" : ['types.read','values.read','types.write','values.write'],
+		"admin" : ['types.read','values.read']
+	});
+
+	entitlement.registerAccounts({
+		"someone@somewhere.com" : ['view'],
+		"mike@somewhere.com" : ['admin']
+	});
+
+	entitlement.accountHasEntitlement('mike@somewhere.com','types.read') // True
+	entitlement.accountHasEntitlement('someone@somewhere.com','types.write') // False
+
+
 ## Legal Stuff
 
 "entitlement" is owned by Markus Felten.  All