address review comments

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
remaining doc update and unit tests

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>