update README and documentation

Author: Péter Hauszknecht

README.md

@@ -90,12 +90,6 @@ A repatch middleware takes the `store` instance, a `next` function and the previ
 Middleware: Store -> Next -> Reducer -> any
 ```
 
-where
-
-```javascript
-Next: Reducer -> Reducer
-```
-
 Use the `addMiddleware` method to chaining middlewares:
 
 ```javascript

docs/store.md

@@ -2,7 +2,7 @@
 
 The `Store` holds the whole state tree of your application. You need to instantiate it.
 
-## Constructor
+## **`constructor(initialState: State)`**
 
 #### Arguments
 
@@ -22,7 +22,7 @@ const store = new Store({ counter: 0 })
 
 ## Methods
 
-### `getState()`
+### **`getState(): State`**
 
 This method returns the current state of the store.
 
@@ -40,17 +40,17 @@ const state = store.getState()
 console.log(state.counter === 0) // true
 ```
 
-### `dispatch(reducer)`
+### **`dispatch(reducer: Reducer): State`**
 
 Dispatches a reducer.
 
 #### Arguments
 
-1) **reducer** (*ReducerFunction: State -> State*): That reducer will reduce the state of the store. This takes the current state and returns the next state.
+1) **reducer** (*Reducer: State -> State*): That reducer will reduce the state of the store. This takes the current state and returns the next state.
 
 #### Returns
 
-(*ReducerFunction*): The final reducer that is made by applying the middlewares - if they are given. If the store does enhanced with middlewares, the `dispatch` method returns the same reducer that was taken as argument.
+(*State*): The new state after reducing.
 
 #### Example
 
@@ -66,19 +66,19 @@ console.log(result === increment) // true
 
 #### Notes
 
-Middlewares can modify the given reducer, so that is not guaranteed that the `dispatch` returns the original reducer that was taken as argument.
+If you use middlewares, that is not guaranteed that the `dispatch` returns the new state. For example `thunk` middleware modify `dispatch` that it returns the result of delegate function.
 
-### `subscribe(listener)`
+### **`subscribe(listener: Listener): Unsubscribe`**
 
 Adds a state change listener.
 
 #### Arguments
 
-1) **listener** (*ListenerFunction: void -> void*): The listener that will be synchronously run after the state was modified by dispatching a reducer.
+1) **listener** (*Listener: void -> void*): The listener that will be synchronously run after the state was modified by dispatching a reducer.
 
 #### Returns
 
-(*UnsubscribeFunction: void -> void*): The unsubscribe function, that you can use to unsubscribe the given listener.
+(*Unsubscribe: void -> void*): The unsubscribe function, that you can use to unsubscribe the given listener.
 
 #### Example
 
@@ -96,15 +96,15 @@ unsubscribe()
 store.dispatch(increment) // listener won't be fired
 ```
 
-### `addMiddleware(...middlewares)`
+### **`addMiddleware(...middlewares: Middleware[]): Store`**
 
 Enhances the store with the given middleware(s).
 
 Middlewares will be run at dispatching before the store applies the new state of the reducer. The added middlewares are composed by order of addition, so the last added middleware will run first.
 
 #### Arguments
 
-1) **...middlewares** (*MiddlewareFunction: Store -> Next -> Reducer -> any*): Middlewares as variadic arguments. Middleware functions take the `store` instance, a `next` function and the previous `reducer`. The middleware can provide a new reducer via the `next` function.
+1) **...middlewares** (*Middleware: Store -> Next -> Reducer -> any*): Middlewares as variadic arguments. Middleware functions take the `store` instance, a `next` function and the previous `reducer`. The middleware can provide a new reducer via the `next` function.
 
 #### Returns
 
@@ -124,10 +124,4 @@ const store = new Store({ counter: 0 }).addMiddleware(logger)
 
 store.dispatch(state => ({ counter: state.counter + 1 }))
 // logger logs { counter: 0 } { counter: 1 }
-```
-
-## Static members
-
-### `thunk`
-
-The [thunk](thunk.md) middleware.
+```

docs/thunk.md

@@ -2,9 +2,7 @@
 
 Thunk is a repatch middleware to handle async actions. It is very similar to [redux-thunk](https://www.npmjs.com/package/redux-thunk). Thunk middleware allows you to create reducers that returns a function (delegate). The delegate will be fired at dispatching.
 
-## ThunkMiddleware
-
-`State -> Delegate`
+`Thunk: State -> Delegate`
 
 #### Example