Explain how the email field works on the People API.

@DavidHuie @arionhardison I made an attempt to explain what to expect when using the `email` field on the People API.

This documentation update is related to [this Trello card](https://trello.com/c/Yf5qSSc5/479-fix-email-field-in-the-people-api).