UID2-6917 Add 20 concurrent requests restriction for /identity/map

[swibi-ttd]

• Add our suggested limit of 20 concurrent requests for /identity/map endpoints
• Fix Documentation Updates entry that was in the wrong quarter

[genwhittTTD]

Thx Sean. Few comments. Also I will open a thread about the level of detail in Doc Updates and copy you on it.

[genwhittTTD]

Say "can" rather than "may" here. We're not giving them permission, we're stating capabilities. (though per the description this is a recommendation? Either way it's not quite right. But we should be clear whether it's a recommendation or a requirement. Suggest:

Suggested change

	- To map a large number of email addresses, phone numbers, or their respective hashes, send them in batches with a maximum of 5,000 items per batch. You may send up to 20 batches in parallel.
	- To map a large number of email addresses, phone numbers, or their respective hashes, send them in batches with a maximum of 5,000 items per batch. We recommend sending no more than 20 batches in parallel.

Or if it's an even more firm recommendation, we could say:

Do not send more than 20 batches in parallel.

That also leaves me wondering why, though. If there's anything we can comfortably share it would be good. Very likely not but checking in case we could say something like this:

To avoid processing delays, do not send more than 20 batches in parallel.

That gives them a purpose. Though, again, it might be too much info.

[genwhittTTD]

Same here.

[genwhittTTD]

We only announce major documents, basically... not small fixes like this. Suggest just remove the new section (leave the fix of course since it's a correction to existing content). Though actually my comment applies to the Rate Limiting changes also.

If there's some specific reason we should include it, OK... but there have been many, many changes that we don't announce. I looked over the doc and appreciate that this isn't clear from the heading.

This is something I'll ask SW and KK about. I'll copy you on it. For now, your call.

[genwhittTTD]

Just saying in case you end up keeping it -- the way this is written it doesn't sound like a limit. It sounds like we're recommending sending lots. Suggest use the same rewording as on the other entries, if that makes sense.

Added a recommendation to send not more than 20 batches in parallel.

Something like that. But better we don't list a doc change this small.