Skip to content

Commit 57e6d71

Browse files
Update GuidelinesGraph.md
1 parent 55e2ef0 commit 57e6d71

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

graph/GuidelinesGraph.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ Table of contents
1414
- [Query support](#query-support)
1515
- [Behavior modeling](#behavior-modeling)
1616
- [Error handling](#error-handling)
17+
- [Limitations on core types](#limitations-on-core-types)
1718
- [External standards](#external-standards)
1819
- [API contract and nonbackward compatible changes](#api-contract-and-nonbackward-compatible-changes)
1920
- [Versioning and deprecation](#versioning-and-deprecation)
@@ -332,6 +333,15 @@ For a complete mapping of error codes to HTTP statuses, see
332333

333334
<a name="api-contract-and-non-backward-compatible-changes"></a>
334335

336+
### Limitations on core types
337+
338+
The types `user`, `group`, and `device` should not have any new structural property(s) added, without compelling justification.
339+
Instead, model the concept represented in those property(s) as a new entity, and do one of the following:
340+
1. Add navigation to the new entity from `user`, `group`, or `device`.
341+
2. Contain the new entity elsewhere, and add a navigation from the new entity to `user`, `group` or `device`.
342+
343+
More details and examples are available in [Core types](./articles/coreTypes.md).
344+
335345
## External standards
336346

337347
For ease of client use and interoperatibility, some APIs might implement a standard that is defined external to Microsoft Graph and OData.

0 commit comments

Comments
 (0)