improve interface documentation