updates to documentation and README