adding README - the lessons learnt