readme and notes