update readme, notes in attributes