new content + fixes (#3827)

* new content + fixes

* fix build issue

* more content

* add forInternalUseOnly

* Apply suggestions from code review

Co-Authored-By: Genevieve Warren <[email protected]>

* Update VsaEngine.xml

Co-authored-by: Genevieve Warren <[email protected]>

Author: mairaw

xml/Microsoft.Build.Tasks.Xaml/CommandLineGenerator.xml

@@ -64,8 +64,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Contains a string of additional options to include on the command line.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets a string of additional options to include on the command line.</summary>
+        <value>A string of additional options to include on the command line.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -93,8 +93,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Contains the string to append to a command line when there is no template.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets the string to append to a command line when there is no template.</summary>
+        <value>The string to append to a command line when there is no template.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -122,8 +122,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Contains the template to use when creating the command line.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets the template to use when creating the command line.</summary>
+        <value>The template to use when creating the command line.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -144,8 +144,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Generates a command line.</summary>
-        <returns>To be added.</returns>
+        <summary>Generates the command line.</summary>
+        <returns>The command line.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/Microsoft.JScript.Vsa/BaseVsaEngine.xml

@@ -855,7 +855,7 @@
         <param name="ident">A string value provided as identifier.</param>
         <summary>Checks whether the supplied identifier is valid for the engine.</summary>
         <returns>
-          <see langword="true" /> if the identifier is valid; otherwise, it returns <see langword="false" />.</returns>
+          <see langword="true" /> if the identifier is valid; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -881,7 +881,7 @@
         <param name="name">A string value provided as identifier.</param>
         <summary>Checks whether the supplied namespace is valid for the engine.</summary>
         <returns>
-          <see langword="true" /> if the namespace is valid; otherwise, it returns <see langword="false" />.</returns>
+          <see langword="true" /> if the namespace is valid; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>