Merge pull request #12480 from ghogen/freshness-april-2024

Review and update

Author: Jill Grant

docs/ide/finding-references.md

@@ -1,7 +1,7 @@
 ---
 title: Finding references in your code
 description: Explore the Find All References command in Visual Studio to find references to particular code elements in your code, including by reference type.
-ms.date: 02/15/2023
+ms.date: 04/10/2024
 ms.topic: conceptual
 helpviewer_keywords:
 - code editor, find all references
@@ -13,30 +13,29 @@ ms.subservice: general-ide
 ---
 # Find references in your code
 
-You can use the **Find All References** command to find where particular code elements are referenced throughout your codebase. The **Find All References** command is available on the context (right-click) menu of the element you want to find references to. Or, if you're a keyboard user, press **Shift + F12**.
+You can use the **Find All References** command to find where particular code elements are referenced throughout your codebase. The **Find All References** command is available on the context (right-click) menu of the element you want to find references to. Or, press **Alt + F2**.
 
 The results appear in a tool window named **\<element> references**, where *element* is the name of the item you're searching for. A toolbar in the **references** window enables you to do the following:
 
-- Change the scope of the search in a drop-down list box. You can choose to look only in changed documents all the way up to the entire solution.
-- Copy the selected referenced item by choosing the **Copy** button.
-- Choose buttons to go to the next or previous location in the list, or press the **F8** and **Shift + F8** keys to do so.
+- Change the scope of the search in a drop-down list box. You can choose to look only in open or changed documents, all the way up to the entire solution.
+- Copy the selected referenced item(s) by choosing the **Copy** button. All the values in all the columns for all selected rows are copied to the clipboard, preceded by the column headings. This makes it easy to paste into a spreadsheet.
+- Choose buttons to go to the next or previous location in the list, or press the up and down arrow keys to do so.
 - Remove any filters on the returned results by choosing the **Clear All Filters** button.
 - Change how returned items are grouped by choosing a setting in the **Group by:** drop-down list box.
 - Keep the current search results window by choosing the **Keep Results** button. When you choose this button, the current search results stay in this window, and new search results appear in a new tool window.
 - Search for strings within the search results by entering text in the **Search Find All References** text box.
 
-You can also hover the mouse over any search result to see a preview of the reference.
+You can also hover the mouse over any search result to see the reference in the context of the surrounding code.
 
 ![Screenshot of the Find All References tool window.](../ide/media/vside_findallreferences.png)
 
 ## Navigate to references
 
 You can use the following methods to navigate to references in the **references** window:
 
-- Press **F8** to go to the next reference, or **Shift + F8** to go to the previous reference.
 - Press the **Enter** key on a reference, or double-click it, to go to it in code.
 - On the right-click menu (context menu) of a reference, choose the **Go To Previous Location** or **Go To Next Location** commands.
-- Choose the **Up Arrow** and **Down Arrow** keys (if they're enabled in the **Options** dialog box). To enable this functionality, on the menu bar, choose **Tools** > **Options** > **Environment** > **Tabs and Windows**, and then in the **Preview Tab** section, select the **Allow new files to be opened in the preview tab** and **Preview selected files in Find Results** boxes.
+- Use the **Up Arrow** and **Down Arrow** keys.
 
 ## Change reference groupings
 
@@ -52,6 +51,10 @@ In C# or Visual Basic, the **Find References** window has a **Kind** column wher
 
 After you apply a filter or a filter set, you can easily remove it by using the **Clear All Filters** button.
 
+## Customize the experience
+
+To customize the experience, on the menu bar, choose **Tools** > **Options** > **Environment** > **Tabs and Windows**, and then in the **Preview Tab** section, if you select the **Allow new files to be opened in the preview tab** checkbox, you can select or unselect the **Preview selected files in Find Results** checkbox. When selected, the file is opened in the editor at the place where the reference occurs. When unset, the file is only opened if you explicitly press **Enter** or double-click on the row.
+
 ## Related content
 
 - [Navigating code](../ide/navigating-code.md)