doc: clarified validate param 'name'

Made it clear(er) the the user/programmer needs to add the name param in case name and id are unequal.