definitive README and proposed files