update readme, add notes