Readme.

Author: odeadglaz

README.md

@@ -35,7 +35,7 @@ app.listen(port);
 
 ```
 
-This will expose the request-level context to all future points that will handle this request making it exposable by accessing the context
+This will expose any point of your code form this point that handles that request. 
 
 ```js
 // ./controller/user/index.js
@@ -47,6 +47,8 @@ const logger = require('../service/logger');
 export class UserController {
     async create (req, res, next) {
         const { user } = req.body;
+        
+        // This will return the reference number set by out ContextMiddleware
         const { reference } = Context.get();
 
         logger.info('Created user for reference: ', reference);
@@ -55,3 +57,61 @@ export class UserController {
     }
 }
 ```
+
+## API
+
+### create(initialContext?: object)
+
+Creates for the current async resource an execution context entry identified with his asyncId.
+Any future processes that will be added to the async execution chain will be exposed to this context.
+
+### update(update: object)
+Updates the current execution context with a given update obect.
+
+### get()
+
+Returns the current execution context identified with the current asyncId.
+
+### API Usage
+
+
+```js
+const Context = require('node-execution-context');
+
+Context.create({
+    value: true
+});
+
+Promise.resolve().then(() => {
+    console.log(Context.get()) // outputs: {"value": true}
+    
+    Context.update({
+        value: false
+    });
+    
+    return new Promise((resolve) => {
+        setTimeout(() => {
+            console.log(Context.get()) // outputs: {"value": false}
+            
+            Context.update({
+                butter: 'fly'
+            });
+            
+            process.nextTick(() => {
+                console.log(Context.get()) // outputs: {"value": false, "butter": 'fly'}
+            });
+            
+        }, 1000);
+        
+        console.log(Context.get()) // outputs: {"value": true}
+    });
+});
+```
+
+The following errors can be thrown while accessing to the context API :
+
+| Code | when |
+|-|-
+| CONTEXT_ALREADY_DECLARED | When trying to `create` execution context, but current async resource already exists.
+| CONTEXT_DOES_NOT_EXISTS | When try to `get` / `update` the context, but it yet been created.
+