adding supplemental files and clarifiy points in the readme