README.md update -- metrics and small API changes