improved README.md formatting
improved changelog formatting
documents changes since last release, esp. docopt
fixed documentation headers