[doc] Updates to core README, and then slim + haml