update readme, notes