rereworked readme notes