Add docs for ok terminator
Rename then to always to avoid confusion with promises
Merge pull request #6 from raoulmillais/chain-docs-improvements

Chain docs improvements