readme and humans update