Merge pull request #5352 from MicrosoftDocs/main638838774565842784sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

.github/copilot-instructions.md

@@ -1,33 +1,27 @@
 When writing documentation, follow the following guidelines:
 
-Follow the style of the [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/).
-
-Headings should be in sentence case, not title case. Don't use gerunds in titles.
-
-Use the active voice whenever possible, and second person to address the reader directly.
-
-Use a conversational tone with contractions.
-
-Be concise.
-
-Break up long sentences.
-
-Use the present tense for instructions and descriptions. For example, "The method returns a value" instead of "The method will return a value."
-
-Do not use "we" or "our" to refer to the authors of the documentation.
-
-Use the imperative mood for instructions. For example, "Call the method" instead of "You should call the method."
-
-Use "might" instead of "may" to indicate possibility. For example, "This method might throw an exception" instead of "This method may throw an exception."
-
-Use the Oxford comma in lists of three or more items.
-
-Number ordered list items all as "1." instead of "1.", "2.", etc. Use bullets for unordered lists.
-
-Use **bold** when referring to UI elements. Use `code style` for file names and folders, custom types, and other text that should never be localized.
-
-Put raw URLs within angle brackets.
-
-Include links to related topics and resources where appropriate. Use relative links if the target file lives in this repo. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link.
-
-If you're adding a new Markdown file, it should be named in all lowercase with hyphens separating words. Also, omit any filler words such as "the" or "a" from the file name.
+- Follow the style of the [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/).
+- Headings should be in sentence case, not title case. Don't use gerunds in titles.
+- Use the active voice whenever possible, and second person to address the reader directly.
+- Use a conversational tone with contractions.
+- Be concise.
+- Break up long sentences.
+- Use the present tense for instructions and descriptions. For example, "The method returns a value" instead of "The method will return a value."
+- Don't use "we" or "our" to refer to the authors of the documentation.
+- Use the imperative mood for instructions. For example, "Call the method" instead of "You should call the method."
+- Use "might" instead of "may" to indicate possibility. For example, "This method might throw an exception" instead of "This method may throw an exception."
+- Use the Oxford comma in lists of three or more items.
+- Number ordered list items all as "1." instead of "1.", "2.", etc. Use bullets for unordered lists.
+- Use **bold** when referring to UI elements. Use `code style` for file names and folders, custom types, and other text that should never be localized.
+- Put raw URLs within angle brackets.
+- When you are going to refer to another file or an article on the web, use a link. For example, "For more information, see [C++ language reference](../cpp/cpp-language-reference.md)." 
+- Include links to related topics and resources where appropriate. Use relative links if the target file lives in this repo. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link.
+- If you're adding a new Markdown file, it should be named in all lowercase with hyphens separating words. Also, omit any filler words such as "the" or "a" from the file name.
+- If you're adding a new Markdown file, the following indicates where it should go the folder structure. If you aren't sure, ask. The following folder structure is how it looks on my hard drive. To map to GitHub, for example, C:\Users\twhitney\repos\cpp-docs-pr\docs\linux is docs/linux
+    If the file is about Linux, put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\linux folder.
+    If the file is about the C++ Standard Template Library (STL), put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\standard-library folder.
+    If the file is about the C runtime, put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\c-runtime-library folder.
+    If the file is about the C++ language, put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\cpp folder.
+    If the file is about a C++ feature specific to the Visual Studio IDE, put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\ide folder.
+    If the file is about the build process or modules, put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\build\reference folder.
+    If the file is about Build Insights, put it in the C:\Users\twhitney\repos\cpp-docs-pr\docs\build-insights folder.

docs/linux/media/remote-file-explorer-download.png

@@ -0,0 +1,106 @@
+---
+title: "Remote file explorer"
+description: "Learn how to use Remote File Explorer to view, upload, and download files on a remote machine form within Visual Studio."
+ms.topic: how-to
+ms.date: 05/21/2025
+---
+# Remote File Explorer
+
+Learn how to use **Remote File Explorer** to view, upload, and download files on a remote machine from Visual Studio. With **Remote File Explorer**, perform common file operations such as:
+
+- Upload files from your local machine to a remote machine
+- Download files from a remote machine to your local machine
+- Create folders on a remote machine
+- Delete files and folders on a remote machine
+- Rename files and folders on a remote machine
+- Search for files and folders on a remote machine
+
+## Prerequisites
+
+Visual Studio version 17.6 or later.
+
+Ensure that the **Linux and embedded development with C++** workload is installed. Run the Visual Studio Installer and ensure that the **Linux and embedded development with C++** workload is selected. Also ensure that the **Remote File Explorer for Linux** component is selected, and update your installation if necessary.
+
+:::image type="content" source="media/linux-workload.png" alt-text="Screenshot of the Visual Studio Installer. The **Linux and embedded development with C++** workload is selected. In the installation details pane, Remote File Explorer for Linux is selected.":::
+
+Install and configure Secure Shell (SSH) on the remote machine. To install SSH on Linux, run these commands on the remote machine:
+
+```bash
+sudo apt update
+sudo apt install openssh-server
+sudo systemctl start ssh
+sudo systemctl status ssh
+```
+
+## View and edit files on a remote machine
+
+In these examples, the remote machine is a Windows Subsystem for Linux instance running on localhost port 22. The project is a new CMake project created in Visual Studio. The sample project is on the remote machine in the `C:\Users\{username}\projects\` folder.
+
+To open the **Remote File Explorer** in Visual Studio, choose **View** > **Other Windows** > **Remote File Explorer**.
+
+:::image type="content" source="media/remote-file-explorer-menu-item.png" alt-text="Screenshot of the Visual Studio View menu. Remote File Explorer is highlighted.":::
+
+The **Remote File Explorer** window opens:
+
+:::image type="content" source="media/remote-file-explorer.png" alt-text="Screenshot of the Remote File Explorer. The folder system on the remote machine is visible.":::
+
+If you see a message to select or create a new connection in the **Connection Manager**, ensure that the SSH server is running on the remote machine. If your remote machine is running on Windows Subsystem for Linux (WSL), ensure that the WSL instance is running. Make sure the Visual Studio debug target dropdown is set to the remote instance. To connect to a different remote machine, in the **Remote File Explorer** window's **Select the host target** dropdown, select the remote target. It may appear in a form such as `username@hostname:port`. For example, `username@localhost:22`. You can also select **Add new connection** to add a new connection to the **Connection Manager**. For more information, see [Connection manager](connect-to-your-remote-linux-computer.md).
+
+Open and edit files directly from the **Remote File Explorer**. To open a file, double-click the file in the **Remote File Explorer** window. The file opens in the editor window. You can also right-click the file and select **Open** from the context menu or press **Ctrl+Enter**. When you save the file, the changes are saved directly to the remote machine.
+
+## Upload files to a remote machine
+
+To upload files or directories to the remote machine, right-click the folder in the **Remote File Explorer** window where you want to upload files, and select **Upload**.
+
+:::image type="content" source="media/remote-file-explorer-upload.png" alt-text="Screenshot of the Remote File Explorer showing the Upload a directory and Upload files menu options.":::
+
+Use the folder explorer window that opens to select the file or folder you want to upload. You can drag and drop files from your local machine onto the **Remote File Explorer** window. Alternatively, use the **Upload Files** or **Upload Folder** buttons to choose the items to upload:
+
+## Download files from a remote machine
+
+To download files or directories from the remote machine, right-click the folder or file in the **Remote File Explorer** window that you want to download and select **Download**.
+
+:::image type="content" source="media/remote-file-explorer-download.png" alt-text="Screenshot of the Remote File Explorer displaying the menu option: Download 'asset.txt'.":::
+
+Use the folder explorer window that opens to select where to download the file or folder. You can also use the **Download Item** button to choose the item you want to download.
+
+## Monitor and cancel file operations
+
+Monitor the progress of uploading or downloading items in the status window at the bottom of the **Remote File Explorer** window. Select the **Cancel** button to stop the operation.
+
+:::image type="content" source="media/remote-file-explorer-progress.png" alt-text="Screenshot of the Remote File Explorer showing the progress indicator. The Cancel button is highlighted.":::
+
+## Other file operations
+
+Rename files and folders, create new folders, delete files and folders, and search for files and folders.
+
+- Rename a file or folder: right-click the file or folder and select **Rename** from the context menu, or select the rename button on the toolbar. The filename becomes editable. Type the new name for the item and press **Enter**.
+- Create a new folder: right-click in the **Remote File Explorer** window and select **New Folder**. Enter a name for the new folder and press **Enter**.
+- Delete a file or folder: right-click the file or folder and select **Delete** from the context menu, or select the delete button on the toolbar. Confirm the deletion in the dialog that appears. Deleting files or folders from the remote machine is a permanent action and can't be undone.
+- Refresh the view: right-click in the **Remote File Explorer** window and select **Refresh** from the context menu, or select the refresh button on the toolbar, or press **F5**. It only refreshes the view of what is selected. If you have a folder selected, it refreshes the view of that folder. If you have a file selected, it refreshes the view of that file.
+- Search for files: enter text in the search box at the top of the **Remote File Explorer** window to find folders or files. The search is case-insensitive and searches all files and folders under the selected item. If a folder is selected, it searches all files and folders in that folder. If a file is selected, it searches all files and folders in the same directory as that file.
+
+## Remote File Explorer toolbar buttons
+
+The **Remote File Explorer** toolbar lets you access remote file operations:
+
+:::image type="content" source="media/remote-file-explorer-toolbar.png" alt-text="Screenshot of the Remote File Explorer toolbar." :::
+
+The highlighted buttons are, from left to right:
+
+- **+**: Create a new Remote Explorer window.
+- **Home**: Go to the `$HOME` directory of the currently signed-in user on the remote machine.
+- **Settings**: Open the settings for the **Remote File Explorer**.
+- **Upload Files**: Upload files from your local machine to the remote machine.
+- **Upload Folder**: Upload a folder from your local machine to the remote machine.
+- **Download Item**: Download a file or folder from the remote machine to your local machine.
+- **Refresh Item**: Refresh the view of the selected item.
+- **Rename Item**: Rename a file or folder on the remote machine.
+- **Delete Item**: Delete a file or folder on the remote machine.
+- **Search**: Search for files or folders on the remote machine.
+
+## See also
+
+- [The Remote File Explorer tool window of Visual Studio (video)](/shows/pure-virtual-cpp-2023/the-remote-file-explorer-tool-window-of-visual-studio)
+- [Connection manager](connect-to-your-remote-linux-computer.md)
+- [Create a CMake Linux project in Visual Studio](cmake-linux-project.md)

docs/linux/media/remote-file-explorer-menu-item.png

@@ -7,6 +7,8 @@ items:
   items:
     - name: Connect to your remote Linux computer
       href: ../linux/connect-to-your-remote-linux-computer.md
+    - name: Remote File Explorer
+      href: ../linux/remote-file-explorer.md
     - name: Set up FIPS-compliant secure remote Linux development
       href: ../linux/set-up-fips-compliant-secure-remote-linux-development.md
     - name: ConnectionManager reference