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.
Merge pull request #624 from ArthurClemens/patch-4

doc: clarified validate param 'name'