update README and file descriptions