update readme & refer to both blobs & filenames where appropriate in the code