From 33033a28460fd7ca5c59af34142a2d5574bf677f Mon Sep 17 00:00:00 2001
From: Mingzhe Huang <archerzz@users.noreply.github.com>
Date: Thu, 11 Jul 2024 11:41:22 +0800
Subject: [PATCH 1/2] fix(docs): wrong <param> location in `System.ClientModel`

---
 .../src/ModelReaderWriter/IPersistableModel.cs                  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs b/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs
index 619db66beb63..42d0a97fbe2c 100644
--- a/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs
+++ b/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs
@@ -29,8 +29,8 @@ public interface IPersistableModel<out T>
 
     /// <summary>
     /// Gets the data interchange format (JSON, Xml, etc) that the model uses when communicating with the service.
-    /// <param name="options">The <see cref="ModelReaderWriterOptions"/> to use.</param>
     /// </summary>
+    /// <param name="options">The <see cref="ModelReaderWriterOptions"/> to use.</param>
     /// <returns>The format that the model uses when communicating with the serivce.</returns>
     string GetFormatFromOptions(ModelReaderWriterOptions options);
 }

From ef1a8c355c8e4b6316c799241cca033f4eca8aab Mon Sep 17 00:00:00 2001
From: Mingzhe Huang <archerzz@users.noreply.github.com>
Date: Thu, 11 Jul 2024 22:56:20 +0800
Subject: [PATCH 2/2] Update parameter description to make the meaning more
 clear.

Co-authored-by: Jesse Squire <jesse.squire@gmail.com>
---
 .../src/ModelReaderWriter/IPersistableModel.cs                  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs b/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs
index 42d0a97fbe2c..1948cd4f6f39 100644
--- a/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs
+++ b/sdk/core/System.ClientModel/src/ModelReaderWriter/IPersistableModel.cs
@@ -30,7 +30,7 @@ public interface IPersistableModel<out T>
     /// <summary>
     /// Gets the data interchange format (JSON, Xml, etc) that the model uses when communicating with the service.
     /// </summary>
-    /// <param name="options">The <see cref="ModelReaderWriterOptions"/> to use.</param>
+    /// <param name="options">The <see cref="ModelReaderWriterOptions"/> to consider when serializing and deserializing the model.</param>
     /// <returns>The format that the model uses when communicating with the serivce.</returns>
     string GetFormatFromOptions(ModelReaderWriterOptions options);
 }