microsoft / api-guidelines

Microsoft REST API Guidelines
Other
22.69k stars 2.71k forks source link

Add guidance for the use of collections of entity types #482

Open corranrogue9 opened 1 year ago

corranrogue9 commented 1 year ago

I'm adding guidance to suggest that collections should be entity types instead of complex types because they can be modified piecewise, while collections of complex types must always be replaced, which can result in data loss and/or race conditions.

Please ignore the commit comments, I will perform a squash merge to complete the PR.