Small docs fixes

API.md

@@ -99,6 +99,9 @@ Returns **[Function][42]**
 
 ## Context
 
+An object that's available in all action handlers and routers as `req.hull`.
+It's a set of parameters and modules to work in the context of current organization and connector instance.
+
 ### helpers
 
 This is a set of additional helper functions being exposed at `req.hull.helpers`. They allow to perform common operation in the context of current request. They are similar o `req.hull.client.utils`, but operate at higher level, ensure good practises and should be used in the first place before falling back to raw utils.
@@ -129,7 +132,7 @@ This is a method to request an extract of user base to be sent back to the Conne
 -   `options` **[Object][37]**  (optional, default `{}`)
     -   `options.segment` **[Object][37]**  (optional, default `null`)
     -   `options.format` **[Object][37]**  (optional, default `json`)
-    -   `options.path` **[Object][37]**  (optional, default `batch`)
+    -   `options.path` **[Object][37]**  (optional, default `/batch`)
     -   `options.fields` **[Object][37]**  (optional, default `[]`)
     -   `options.additionalQuery` **[Object][37]**  (optional, default `{}`)
 

README.md

@@ -113,7 +113,7 @@ To get more details on how those helpers methods work please see [API REFERENCE]
 
 # Context Object
 
-[Hull.Connector](#hullconnector) apply multiple middlewares to the request handler, including [Hull.Middleware](#hullmiddleware). The result is a **Context Object** that's available in all action handlers and routers as `req.hull`. It's a set of parameters and modules to work in the context of current organization and connector instance. This Context is divided into a base set by `Hull.Middleware` (if you use it standalone) and an extended set applied when using `Hull.Connector` and helpers method descibed above.
+[Hull.Connector](#hullconnector) apply multiple middlewares to the request handler, including [Hull.Middleware](#hullmiddleware). The result is a **Context Object** that's available in all action handlers and routers as `req.hull`. It's a set of parameters and modules to work in the context of current organization and connector instance. This Context is divided into a base set by `Hull.Middleware` (if you use it standalone) and an extended set applied when using `Hull.Connector` and helpers method described above.
 
 Here is the base structure of the Context Object (we also provide Flow type for this object [here](./src/types/hull-req-context.js)).
 

src/helpers/request-extract.js

@@ -12,7 +12,7 @@ const _ = require("lodash");
  * @param {Object} [options={}]
  * @param {Object} [options.segment=null]
  * @param {Object} [options.format=json]
- * @param {Object} [options.path=batch]
+ * @param {Object} [options.path=/batch]
  * @param {Object} [options.fields=[]]
  * @param {Object} [options.additionalQuery={}]
  * @return {Promise}

src/index.js

@@ -25,6 +25,9 @@ export type {
 */
 
 /**
+ * An object that's available in all action handlers and routers as `req.hull`.
+ * It's a set of parameters and modules to work in the context of current organization and connector instance.
+ *
  * @namespace Context
  * @public
  */