README aligned to new public api spec.