updated readme to reflect recent interface discussions