Skip to content

Commit e943d38

Browse files
committed
soften recommendation
1 parent 63d7201 commit e943d38

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

graph/patterns/viewpoint.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,10 @@ A shared resource, such as a website or a group message, may have different stat
1010
## Solution
1111

1212
The viewpoint pattern provides a solution to how to model an individual user context on a shared resource using a `viewpoint` structural property on an API entity type.
13-
For example, the `viewpoint` property can indicate whether a message is read, deleted, or flagged for a given user.
13+
For example, the `viewpoint` property can indicate whether a message is read, deleted, or flagged for a given user.
1414
The consistent naming convention ensures that when a developer uses Graph APIs all ‘viewpoints’ structural properties represent type specific user context across different M365 services and features.
1515

16-
This pattern simplifies the API client logic by hiding the state transition details and providing state persistency on the server side. The server can manage the different viewpoints for the shared resource without exposing them to the client. The `viewpoint` property should also be filterable.
16+
This pattern simplifies the API client logic by hiding the state transition details and providing state persistency on the server side. The server can manage the different viewpoints for the shared resource without exposing additional complexity to the client.To support queries for a user state the `viewpoint` property should support be filterable.
1717
## Issues and considerations
1818

1919
- Because the `viewpoint` property reflects an individual user's context, it is null when accessed with application permissions.
@@ -88,7 +88,7 @@ Content-type: application/json
8888
```
8989
### Updating a viewpoint
9090

91-
You can update the `viewpoint` property only if the server does not compute it automatically. Updating the `viewpoint` property usually has a side effect, so you should use an OData action to perform the update.
91+
You can update the `viewpoint` property only if the server does not compute it automatically. Updating the `viewpoint` property usually has a side effect, so you may want to use an OData action to perform the update.
9292

9393
The following example shows marking a chat as read for a user:
9494

0 commit comments

Comments
 (0)