interface and README updates