Formatting and adding more to the documentation
Minor rephrasing to the documentation.
Merge pull request #11 from ffilozov/doc

Adding more documentation and changing some of the format
Merge branch 'zmq3' into rp