Update README and commentary on files