New readme.md and core changes