add installation section, tweak documentation and formatting