update readme with the interface description and misc.