README driven developing the new (less verbose) api