enrich README file and state changes to come