index and readme update (re-cap)