Enhancing the doc for person 'names' property

I think that the "preferred value" concept that is documented in other
places should also apply to person names.
Merge pull request #262 from jdsumsion/master

Enhancing the doc for person 'names' property