Use xml documentation child blocks correctly (#14249)

xtqqczze · web-flow · commit b5fc2f34e493 · 2020-11-26T10:36:23.000+05:00
diff --git a/src/Microsoft.Management.Infrastructure.CimCmdlets/CimSessionProxy.cs b/src/Microsoft.Management.Infrastructure.CimCmdlets/CimSessionProxy.cs
@@ -91,20 +91,20 @@ internal InvocationContext(string computerName, CimInstance targetCimInstance)
         /// <para>
         /// ComputerName of the session
         /// </para>
+        /// </summary>
         /// <remarks>
         /// return value could be null
         /// </remarks>
-        /// </summary>
         internal virtual string ComputerName { get; }
 
         /// <summary>
         /// <para>
         /// CimInstance on which the current operation against.
         /// </para>
+        /// </summary>
         /// <remarks>
         /// return value could be null
         /// </remarks>
-        /// </summary>
         internal virtual CimInstance TargetCimInstance { get; }
     }
     #endregion
diff --git a/src/Microsoft.Management.Infrastructure.CimCmdlets/NewCimSessionCommand.cs b/src/Microsoft.Management.Infrastructure.CimCmdlets/NewCimSessionCommand.cs
@@ -97,7 +97,7 @@ public PasswordAuthenticationMechanism Authentication
         /// </para>
         /// <para>
         /// The unit is Second.
-        /// <para>
+        /// </para>
         /// </summary>
         [Alias(AliasOT)]
         [Parameter(ValueFromPipelineByPropertyName = true)]
@@ -153,9 +153,11 @@ public UInt32 Port
         /// If the argument is not given, a default SessionOption will be created for
         /// the session in .NET API layer.
         /// </para>
+        /// <para>
         /// If a <see cref="DCOMSessionOption"/> object is passed, then
         /// connection is made using DCOM. If a <see cref="WsManSessionOption"/>
         /// object is passed, then connection is made using WsMan.
+        /// </para>
         /// </summary>
         [Parameter(ValueFromPipelineByPropertyName = true)]
         public Microsoft.Management.Infrastructure.Options.CimSessionOptions SessionOption { get; set; }
diff --git a/src/Microsoft.Management.Infrastructure.CimCmdlets/SetCimInstanceCommand.cs b/src/Microsoft.Management.Infrastructure.CimCmdlets/SetCimInstanceCommand.cs
@@ -256,8 +256,10 @@ public IDictionary Property
         private IDictionary property;
 
         /// <summary>
+        /// <para>
         /// The following is the definition of the input parameter "PassThru",
         /// indicate whether Set-CimInstance should output modified result instance or not.
+        /// </para>
         /// <para>
         /// True indicates output the result instance, otherwise output nothing as by default
         /// behavior.
diff --git a/src/Microsoft.PowerShell.Commands.Utility/commands/utility/WebCmdlet/ConvertToJsonCommand.cs b/src/Microsoft.PowerShell.Commands.Utility/commands/utility/WebCmdlet/ConvertToJsonCommand.cs
@@ -72,7 +72,7 @@ public int Depth
         /// <summary>
         /// Specifies how strings are escaped when writing JSON text.
         /// If the EscapeHandling property is set to EscapeHtml, the result JSON string will
-        /// be returned with HTML (<, >, &, ', ") and control characters (e.g. newline) are escaped.
+        /// be returned with HTML (&lt;, &gt;, &amp;, ', ") and control characters (e.g. newline) are escaped.
         /// </summary>
         [Parameter]
         public StringEscapeHandling EscapeHandling { get; set; } = StringEscapeHandling.Default;
