From ef3993805c1b19f556f101c71f1f5401d73eafd6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Heiko=20Thei=C3=9Fen?= <heiko.theissen@sap.com>
Date: Thu, 12 Sep 2024 08:42:36 +0200
Subject: [PATCH] Explain example

---
 docs/odata-protocol/odata-protocol.html  | 3 ++-
 docs/odata-protocol/odata-protocol.md    | 4 +++-
 odata-protocol/11.4 Data Modification.md | 4 +++-
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/docs/odata-protocol/odata-protocol.html b/docs/odata-protocol/odata-protocol.html
index 085fd07e..aada541c 100644
--- a/docs/odata-protocol/odata-protocol.html
+++ b/docs/odata-protocol/odata-protocol.html
@@ -2472,7 +2472,8 @@ <h4 id="11431-update-related-entities-when-updating-an-entity"><a id="UpdateRela
 <span id="cb98-29"><a href="#cb98-29" aria-hidden="true" tabindex="-1"></a><span class="fu">}</span></span></code></pre></div>
 </div>
 <div class="example">
-<p>Example 80: When updating an entity with a 4.01 <code>PUT</code> request, the target of a non-containment navigation property can be replaced without changing either the old or the new targeted entity itself. The targeted entity can then only be specified by an entity reference (see <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.02/odata-json-format-v4.02.html#EntityReference">OData-JSON, section “Entity Reference”</a>):</p>
+<p>Example 80: When updating an entity with a 4.01 <code>PUT</code> request, the target of a non-containment navigation property can be replaced without changing either the old or the new targeted entity itself. The targeted entity can then only be specified by an entity reference (see <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.02/odata-json-format-v4.02.html#EntityReference">OData-JSON, section “Entity Reference”</a>).</p>
+<p>The following JSON payload changes the last name and the manager of Suzanne Brown:</p>
 <div class="sourceCode" id="cb99"><pre class="sourceCode json"><code class="sourceCode json"><span id="cb99-1"><a href="#cb99-1" aria-hidden="true" tabindex="-1"></a><span class="er">PUT</span> <span class="er">http://host/service/Employees(7)</span></span>
 <span id="cb99-2"><a href="#cb99-2" aria-hidden="true" tabindex="-1"></a><span class="er">Content-Type:</span> <span class="er">application/json</span></span>
 <span id="cb99-3"><a href="#cb99-3" aria-hidden="true" tabindex="-1"></a></span>
diff --git a/docs/odata-protocol/odata-protocol.md b/docs/odata-protocol/odata-protocol.md
index c978a458..f9e1b2cd 100644
--- a/docs/odata-protocol/odata-protocol.md
+++ b/docs/odata-protocol/odata-protocol.md
@@ -4555,7 +4555,9 @@ nested delta representation to:
 Example 80: When updating an entity with a 4.01 `PUT` request, the target of a
 non-containment navigation property can be replaced without changing either the
 old or the new targeted entity itself. The targeted entity can then only be
-specified by an entity reference (see [OData-JSON, section "Entity Reference"](https://docs.oasis-open.org/odata/odata-json-format/v4.02/odata-json-format-v4.02.html#EntityReference)):
+specified by an entity reference (see [OData-JSON, section "Entity Reference"](https://docs.oasis-open.org/odata/odata-json-format/v4.02/odata-json-format-v4.02.html#EntityReference)).
+
+The following JSON payload changes the last name and the manager of Suzanne Brown:
 ```json
 PUT http://host/service/Employees(7)
 Content-Type: application/json
diff --git a/odata-protocol/11.4 Data Modification.md b/odata-protocol/11.4 Data Modification.md
index a2c94210..35ff4cdf 100644
--- a/odata-protocol/11.4 Data Modification.md	
+++ b/odata-protocol/11.4 Data Modification.md	
@@ -551,7 +551,9 @@ nested delta representation to:
 Example ##ex: When updating an entity with a 4.01 `PUT` request, the target of a
 non-containment navigation property can be replaced without changing either the
 old or the new targeted entity itself. The targeted entity can then only be
-specified by an entity reference (see [OData-JSON, section "Entity Reference"]($$$OData-JSON$$$#EntityReference)):
+specified by an entity reference (see [OData-JSON, section "Entity Reference"]($$$OData-JSON$$$#EntityReference)).
+
+The following JSON payload changes the last name and the manager of Suzanne Brown:
 ```json
 PUT http://host/service/Employees(7)
 Content-Type: application/json