Skip to content

Commit dd9fd4e

Browse files
authored
Update collections.md
1 parent 9b32887 commit dd9fd4e

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

graph/articles/collections.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -320,12 +320,8 @@ Content-Type: application/json
320320
## 11. Collections of structural types (complex types or primitive types)
321321

322322
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.
323-
324-
Sometimes, structural collection properties are added to a type and then scenarios are discovered later that require a collection of entity types. In these cases, there are two options forward:
325-
326-
### 11.1 Side-by-side collection properties
327-
328-
If there's an entity type `foo` that has a collection of `bar`s:
323+
Sometimes, structural collection properties are added to a type and then scenarios are discovered later that require a collection of entity types.
324+
Take the following model with an entity type `foo` that has a collection of `bar`s:
329325

330326
```xml
331327
<EntityType Name="foo">
@@ -341,7 +337,12 @@ If there's an entity type `foo` that has a collection of `bar`s:
341337
<Property Name="prop2" Type="Edm.String" />
342338
</ComplexType>
343339
```
344-
and a scenario arises that requires, for example, to remove individual `bar`s from the collection, the model can be updated to have two collections side-by-side:
340+
and a scenario arises that requires, for example, to remove individual `bar`s from the collection.
341+
There are two options forward:
342+
343+
### 11.1 Side-by-side collection properties
344+
345+
The model can be updated to have two collections side-by-side:
345346
```diff
346347
<EntityType Name="foo">
347348
<Key>
@@ -407,7 +408,7 @@ HTTP/1.1 400 Bad Request
407408
TODO should this be a 409 conflict instead?
408409
TODO implement this in WebApi
409410

410-
### 11.2 TODO $select trickery
411+
### 11.2 `$select` overloading
411412

412413

413414

0 commit comments

Comments
 (0)