readme update

Adding some explanation to the folders and the files used or created by
the scripts