rework intended interface in the README