Merge pull request #13738 from olegtk/main

improve find in files command documentation

Author: AnnaMHuff

docs/ide/reference/find-in-files-command.md

@@ -35,8 +35,14 @@ Edit.FindinFiles findwhat [/append] [/case] [/ext:extensions]
 Required. The text to match.
 
 ## Switches
-/append  (new in Visual Studio 2022)\
-Optional. Directs the results from the current search to be appended to previous search results.
+/append: `resultwindowname`  (new in Visual Studio 2022)\
+Optional. Directs the results from the current search to be appended to previous search results, identified by `resultwindowname` argument. Find Result windows are named by the first search term that resulted in creation of the window. 
+
+#### Example
+```cmd
+>Edit.FindinFiles "AdornmentTagComparer" /lookin:"Entire Solution"
+>Edit.FindinFiles "TagComparer" /lookin:"Entire Solution" /append:"AdornmentTagComparer"
+```
 
 /case or /c\
 Optional. Matches occur only if the uppercase and lowercase characters exactly match those specified in the `findwhat` argument.
@@ -54,7 +60,7 @@ Optional. Displays a list of file names that contain matches.
 Optional. Displays a list of the current find option settings and does not perform a search.
 
 /regex or /r\
-Optional. Uses pre-defined special characters in the `findwhat` argument as notations that represent patterns of text rather than the literal characters. For a complete list of regular expression characters, see [Regular Expressions](../../ide/using-regular-expressions-in-visual-studio.md).
+Optional. Uses predefined special characters in the `findwhat` argument as notations that represent patterns of text rather than the literal characters. For a complete list of regular expression characters, see [Regular Expressions](../../ide/using-regular-expressions-in-visual-studio.md).
 
 /reset or /e\
 Optional. Returns the find options to their default settings and does not perform a search.
@@ -73,7 +79,7 @@ Optional. Searches the subfolders within the directory specified in the /lookin:
 Optional. Displays the results of the search in the Find Results 2 window.
 
 /wild or /l\ (not supported in Visual Studio 2022)
-Optional. Uses pre-defined special characters in the `findwhat` argument as notations to represent a character or sequence of characters.
+Optional. Uses predefined special characters in the `findwhat` argument as notations to represent a character or sequence of characters.
 
 /word or /w\
 Optional. Searches only for whole words.

docs/ide/reference/replace-in-files-command.md

@@ -40,9 +40,15 @@ Required. The text to substitute for the matched text.
 
 Optional. Replaces all occurrences of the search text with the replacement text.
 
-/append (new in Visual Studio 2022)
+/append: `resultwindowname`  (new in Visual Studio 2022)
 
-Optional. Directs the results from the current search to be appended to previous search results.
+Optional. Directs the results from the current search to be appended to previous replace results, identified by `resultwindowname` argument. Replace Result windows are named following the following pattern: Replace "findWhat" with "replaceWith".
+
+#### Example (note that Command Window uses ^ character to escape quotes)
+```cmd
+>Edit.ReplaceInFiles "Console.WriteLine(" "//Console.WriteLine("  /lookin:"Entire Solution" /a
+>Edit.ReplaceInFiles "Console.Write(" "//Console.Write("  /lookin:"Entire Solution" /a /append:"Replace ^"Console.WriteLine(^" with ^"//Console.WriteLine(^""
+```
 
 /case or /c
 
@@ -70,7 +76,7 @@ Optional. Preserves the original casing of each match in your code.
 
 /regex or /r
 
-Optional. Uses pre-defined special characters in the `findwhat` argument as notations that represent patterns of text rather than the literal characters. For a complete list of regular expression characters, see [Regular Expressions](../../ide/using-regular-expressions-in-visual-studio.md).
+Optional. Uses predefined special characters in the `findwhat` argument as notations that represent patterns of text rather than the literal characters. For a complete list of regular expression characters, see [Regular Expressions](../../ide/using-regular-expressions-in-visual-studio.md).
 
 /reset or /e
 
@@ -94,7 +100,7 @@ Optional. Displays the results of the replacement in the **Find Results 2** wind
 
 /wild or /l  (not supported in Visual Studio 2022)
 
-Optional. Uses pre-defined special characters in the `findwhat` argument as notations to represent a character or sequence of characters.
+Optional. Uses predefined special characters in the `findwhat` argument as notations to represent a character or sequence of characters.
 
 /word or /w