Add documentation for public API

I though some documentation would be good to have for new users. This is a start. Together with cleaning up the public API as in https://github.com/jcelliott/turnpike/issues/16 it will be a well documented and clean library.