Merge pull request #12152 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Speech.Recognition.SrgsGrammar/SrgsDocument.xml

@@ -31,6 +31,8 @@
     <remarks>
       <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  You can you construct an empty <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> instance and build a grammar by adding instances of classes that represent SRGS elements, such as <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule>, <xref:System.Speech.Recognition.SrgsGrammar.SrgsOneOf>,<xref:System.Speech.Recognition.SrgsGrammar.SrgsItem>, <xref:System.Speech.Recognition.SrgsGrammar.SrgsRuleRef>, <xref:System.Speech.Recognition.SrgsGrammar.SrgsSemanticInterpretationTag>, and <xref:System.Speech.Recognition.SrgsGrammar.SrgsToken>. You can also construct an <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> instance from an existing SRGS-compliant XML grammar file, from an instance of <xref:System.Speech.Recognition.SrgsGrammar.SrgsRule>, or from an instance of <xref:System.Speech.Recognition.GrammarBuilder>.
 
@@ -284,6 +286,8 @@ recognizer.LoadGrammarAsync(g);
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Examples
  The following example creates a new <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> from the file named "srgsDocumentFile.xml".
 
@@ -326,6 +330,8 @@ if (File.Exists(srgsDocumentFile))
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Examples
  The following example creates a new instance of <xref:System.Speech.Recognition.SrgsGrammar.SrgsDocument> from an instance of <xref:System.Xml.XmlReader> that references the file "srgsDocumentFile.xml".
 

xml/System.Speech.Recognition/Grammar.xml

@@ -437,6 +437,8 @@ private static Grammar CreateSrgsDocumentGrammar()
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  This constructor does not pass any parameters to the initialization handler, and the description should not define an initialization handler that requires arguments.
 
@@ -540,6 +542,8 @@ private static Grammar CreateGrammarFromFile()
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  This constructor does not pass any parameters to the initialization handler, and the description should not define an initialization handler that requires arguments.
 
@@ -774,6 +778,8 @@ namespace SampleRecognition
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  This constructor does not pass any parameters to the initialization handler, and the description should not define an initialization handler that requires arguments.
 
@@ -1223,6 +1229,8 @@ private static Grammar CreateSrgsDocumentGrammar3()
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  Parameters for an initialization handler may also be specified.
 

xml/System.Speech.Recognition/GrammarBuilder.xml

@@ -2002,6 +2002,8 @@ grammarWithDictation.Name = "Grammar with Dictation";
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  The URI provided by the `path` argument may be local or remote. The application must have read access to the location of specified grammar files.
 
@@ -2089,6 +2091,8 @@ private static Grammar CreateCitiesGrammar1()
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  The URI provided by the `path` argument may be local or remote. The application must have read access to the location of specified grammar files.
 

xml/System.Speech.Synthesis/PromptBuilder.xml

@@ -200,7 +200,13 @@ public void MySimpleText ()
       <Docs>
         <param name="path">A fully qualified path to the audio file.</param>
         <summary>Appends the specified audio file to the <see cref="T:System.Speech.Synthesis.PromptBuilder" />.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+[!INCLUDE [untrusted-data-class-note](~/includes/untrusted-data-class-note.md)]
+
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="AppendAudio">
@@ -960,6 +966,8 @@ namespace SampleSynthesis
         <remarks>
           <format type="text/markdown"><![CDATA[
 
+[!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)]
+
 ## Remarks
  The SSML file must be an XML-format file that conforms to the [Speech Synthesis Markup Language (SSML) Version 1.0](https://www.w3.org/TR/speech-synthesis/) specification.