docs tidy up
additional documentation.

- clarified make_chan.
- simplified the introduction.