Skip to content

Commit 4d8039d

Browse files
Update graph/articles/collections.md
Co-authored-by: Michael Pizzo <[email protected]>
1 parent cdcb0e3 commit 4d8039d

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

graph/articles/collections.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,7 @@ Content-Type: application/json
319319

320320
## 11. Collections of structural types (complex types or primitive types)
321321

322-
Collections of entity types are generally preferable to collections of structual types because collections of structural types must be updated as a single unit, meaning that they are overwritten entirely by new contents, rather than be updated relative to the existing contents.
322+
Entity types are generally preferred for collections since complex types within a collection cannot be individually referenced. Collections of complex types, including any nested properties, must be updated as a single unit, entirely replacing the existing contents. Even if your API is read-only today, modeling it as a collection of entities gives you more flexibility in referencing individual members now and in the future.
323323
Sometimes, structural collection properties are added to a type and then scenarios are discovered later that require a collection of entity types.
324324
Take the following model with an entity type `application` that has a collection of `keyCredential`s:
325325

0 commit comments

Comments
 (0)