Improve If-Match/ETag clarity for developers

- If-Match now mentions both @microsoft.graph.sectionsVersion and
  @odata.etag as equivalent sources, so developers don't need an
  extra list call when they already have a section object
- Add NOTE callout in create, update, add-item, and move responses
  telling developers to use the updated @odata.etag for subsequent
  mutation operations

Author: jsinghmokha

api-reference/beta/api/teamworksection-delete.md

@@ -37,7 +37,7 @@ DELETE /users/{user-id}/teamwork/sections/{teamworkSection-id}
 | Header | Value |
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
-| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
+| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
 
 ## Request body
 

api-reference/beta/api/teamworksection-get.md

@@ -41,7 +41,7 @@ This method doesn't support [OData query parameters](/graph/query-parameters) to
 | Header | Value |
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
-| If-None-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). If the section hierarchy didn't change, this header causes a `304 Not Modified` response. Optional. |
+| If-None-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). If the section hierarchy didn't change, this header causes a `304 Not Modified` response. Optional. |
 
 ## Request body
 

api-reference/beta/api/teamworksection-post-items.md

@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
 | Content-Type | application/json. Required. |
-| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
+| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
 
 ## Request body
 
@@ -54,6 +54,9 @@ The following table lists the properties that you can set when you add a **teamw
 
 If successful, this method returns a `201 Created` response code and a [teamworkSectionItem](../resources/teamworksectionitem.md) object in the response body.
 
+> [!NOTE]
+> The response includes an updated **@odata.etag** value. Use this value as the `If-Match` header for any subsequent mutation operations.
+
 The following errors can occur:
 
 | Scenario | HTTP code | Error code | Message |

api-reference/beta/api/teamworksection-update.md

@@ -38,7 +38,7 @@ PATCH /users/{user-id}/teamwork/sections/{teamworkSection-id}
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
 | Content-Type | application/json. Required. |
-| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
+| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
 
 ## Request body
 
@@ -61,6 +61,9 @@ In the request body, supply a JSON representation of only the properties to upda
 
 If successful, this method returns a `200 OK` response code and an updated [teamworkSection](../resources/teamworksection.md) object in the response body.
 
+> [!NOTE]
+> The response includes an updated **@odata.etag** value. Use this value as the `If-Match` header for any subsequent mutation operations.
+
 If the request specifies an unsupported **sortType** for the section type, this method returns a `400 Bad Request` response code. For more information, see the [Request body](#request-body) section.
 
 ## Examples

api-reference/beta/api/teamworksectionitem-delete.md

@@ -37,7 +37,7 @@ DELETE /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSe
 | Header | Value |
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
-| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
+| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
 
 ## Request body
 

api-reference/beta/api/teamworksectionitem-move.md

@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSect
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
 | Content-Type | application/json. Required. |
-| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
+| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
 
 ## Request body
 
@@ -54,6 +54,9 @@ The following table lists the parameters that are required when you call this ac
 
 If successful, this action returns a `200 OK` response code and a [teamworkSectionItem](../resources/teamworksectionitem.md) in the response body that represents the item in the target section.
 
+> [!NOTE]
+> The response includes an updated **@odata.etag** value. Use this value as the `If-Match` header for any subsequent mutation operations.
+
 ## Examples
 
 ### Request

api-reference/beta/api/userteamwork-post-sections.md

@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections
 |:-------|:------|
 | Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
 | Content-Type | application/json. Required. |
-| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
+| If-Match | The value of the **@microsoft.graph.sectionsVersion** annotation from [listing sections](userteamwork-list-sections.md), or equivalently the **@odata.etag** value from any previously retrieved [section](../resources/teamworksection.md). Required for optimistic concurrency control. |
 
 ## Request body
 
@@ -57,6 +57,9 @@ The following table lists the properties that you can set when you create a **te
 
 If successful, this method returns a `201 Created` response code and a [teamworkSection](../resources/teamworksection.md) object in the response body.
 
+> [!NOTE]
+> The response includes an updated **@odata.etag** value. Use this value as the `If-Match` header for any subsequent mutation operations.
+
 ## Examples
 
 ### Request