changes to the interface's doc part 2