Skip to content

Commit 6bf55a7

Browse files
committed
Improve/explain polymorphic types in arrays guidance
1 parent 8765c85 commit 6bf55a7

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

azure/Guidelines.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -556,7 +556,9 @@ Both Rectangle and Circle have common fields: `kind`, `fillColor`, `lineColor`,
556556
:warning: **YOU SHOULD NOT** return properties of a polymorphic type that are not defined for the api-version specified in the request.
557557

558558
<a name="json-polymorphism-arrays"></a>
559-
:warning: **YOU SHOULD NOT** have a property whose value is an array of polymorphic objects.
559+
:warning: **YOU SHOULD NOT** have a property of an updatable resource whose value is an array of polymorphic objects.
560+
561+
Updating an array property with JSON merge-patch is not version-resilient if the array contains polymorphic types.
560562

561563
## Common API Patterns
562564

0 commit comments

Comments
 (0)