enhance readme for the new core function