Added proposed modifications to the API and README