core: several updates to the README