Documentation needs more clarity around identification

[JulianKingman]

The react native documentation is lacking detail around identification that makes it confusing. Here's what I've run into so far:

• Do we need to set up identification in the native code in order to use the SDK? It says it's optional, but also says here that we need to set up identity requests in the native code first.
• Before a user has identifying information available, what should we be using to identify them? IDFA? Are they automatically identified through the IDFA when an identity request is created, as specified in the iOS docs? I see that there could be a lot of flexibility in how to do this, but I really would like to be shown the "recommended way" to handle it.
• Does the comment about IDFA's no longer being included automatically need to be handled somehow? Not sure how to do this.
• None of the functions documented are described, so I'm left to guess the difference between new MParticle.IdentityRequest, MParticle.Identity.identify, MParticle.Identity.login, MParticle.Identity.logout and MParticle.Identity.modify. There's some description of the corollary functions in the iOS SDK docs, so it shouldn't take much to update the react native docs.
• What's the difference between request.setUserIdentity('[email protected]', MParticle.UserIdentityType.Email) and var request = new MParticle.IdentityRequest(); request.email = '[email protected]' MParticle.Identity.identify(request);
• How do we add multiple identifiers in a row? I assume that involves setting request properties sequentially before running MParticle.Identity.identify(request), it would be nice to see an example.
• Should I be using the same IdentityRequest class instance throughout the app, for example to run login, identify and modify commands?

Unrelated: pod setup in the docs doesn't indicate specific versions. Auto-linking should solve this.

[shr-GE]

there is no documentation for parameters for new mParticle.Product(...args) . when i try to add new param attribute to this function it does not show in on the live stream . there is no documentation for what is order in which the keys should be sent. or what is proper process for adding a new key to product event