big updates to the README for file format