docs: refine README to include latest API changes