From 318d4adc88d48b607d712657a4b551910080dbbd Mon Sep 17 00:00:00 2001
From: Christopher Scott <chriss@microsoft.com>
Date: Thu, 25 Jun 2020 18:02:03 -0500
Subject: [PATCH] Comment description proposal for get only mutable collection
 properties (#12981)

* comment description proposal for get only mutable collection properties

* add link, add text to other options
---
 .../src/ImportCertificateOptions.cs                            | 3 ++-
 .../src/MergeCertificateOptions.cs                             | 3 ++-
 .../Azure.Security.KeyVault.Keys/src/CreateKeyOptions.cs       | 3 ++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/ImportCertificateOptions.cs b/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/ImportCertificateOptions.cs
index b4da48e4fa1ef..0284726afa6f6 100644
--- a/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/ImportCertificateOptions.cs
+++ b/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/ImportCertificateOptions.cs
@@ -66,7 +66,8 @@ public ImportCertificateOptions(string name, byte[] certificate)
         public bool? Enabled { get; set; }
 
         /// <summary>
-        /// Gets the tags to be applied to the imported certificate.
+        /// Gets the tags to be applied to the imported certificate. Although this collection cannot be set, it can be modified
+        ///  or initialized with a <see href="https://docs.microsoft.com/dotnet/csharp/programming-guide/classes-and-structs/how-to-initialize-a-dictionary-with-a-collection-initializer">collection initializer</see>.
         /// </summary>
         public IDictionary<string, string> Tags => LazyInitializer.EnsureInitialized(ref _tags);
 
diff --git a/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/MergeCertificateOptions.cs b/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/MergeCertificateOptions.cs
index 036907d0a01ed..c006a221a209c 100644
--- a/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/MergeCertificateOptions.cs
+++ b/sdk/keyvault/Azure.Security.KeyVault.Certificates/src/MergeCertificateOptions.cs
@@ -53,7 +53,8 @@ public MergeCertificateOptions(string name, IEnumerable<byte[]> x509Certificates
         public bool? Enabled { get; set; }
 
         /// <summary>
-        /// Gets the tags to be applied to the merged certificate.
+        /// Gets the tags to be applied to the merged certificate. Although this collection cannot be set, it can be modified
+        ///  or initialized with a <see href="https://docs.microsoft.com/dotnet/csharp/programming-guide/classes-and-structs/how-to-initialize-a-dictionary-with-a-collection-initializer">collection initializer</see>.
         /// </summary>
         public IDictionary<string, string> Tags => LazyInitializer.EnsureInitialized(ref _tags);
 
diff --git a/sdk/keyvault/Azure.Security.KeyVault.Keys/src/CreateKeyOptions.cs b/sdk/keyvault/Azure.Security.KeyVault.Keys/src/CreateKeyOptions.cs
index 341635e1af372..eb604ca03cd46 100644
--- a/sdk/keyvault/Azure.Security.KeyVault.Keys/src/CreateKeyOptions.cs
+++ b/sdk/keyvault/Azure.Security.KeyVault.Keys/src/CreateKeyOptions.cs
@@ -39,7 +39,8 @@ public CreateKeyOptions()
         public bool? Enabled { get; set; }
 
         /// <summary>
-        /// Gets a dictionary of tags with specific metadata about the key.
+        /// Gets a dictionary of tags with specific metadata about the key. Although this collection cannot be set, it can be modified
+        ///  or initialized with a <see href="https://docs.microsoft.com/dotnet/csharp/programming-guide/classes-and-structs/how-to-initialize-a-dictionary-with-a-collection-initializer">collection initializer</see>.
         /// </summary>
         public IDictionary<string, string> Tags { get; } = new Dictionary<string, string>();
     }