Merge branch 'main' into alvinashcraft/main-windev-faq-freshness-and-combine

Author: alvinashcraft

hub/dev-environment/javascript/nodejs-on-windows.md

@@ -2,7 +2,7 @@
 title: Set up Node.js on native Windows
 description: A guide to help you get your Node.js development environment set up directly on Windows.
 ms.topic: article
-ms.date: 11/26/2024
+ms.date: 12/12/2024
 ---
 
 # Install Node.js on Windows
@@ -29,14 +29,14 @@ Besides choosing whether to install on Windows or WSL, there are additional choi
 > [!WARNING]
 > NVM is designed to be installed per-user, and invoked per-shell. It is not designed for shared developer boxes or build servers with multiple build agents. NVM works by using a symbolic link. Using nvm in shared scenarios creates a problem because that link points to a user's app data folder -- so if user x runs `nvm use lts`, the link will point node for the entire box to their app data folder. If user y runs node or npm, they will be directed to run files under x's user account and in the case of `npm -g`, they will be modifying x's files, which by default is not allowed. So nvm is only prescribed for one developer box. This goes for build servers too. If two build agents are on the same vm/box, they can compete and cause odd behavior in the builds.
 
-1. Follow the install instructions on the [windows-nvm repository](https://github.com/coreybutler/nvm-windows#installation--upgrades). We recommend using the installer, but if you have a more advanced understanding of your needs, you may want to consider the manual installation. The installer will point you to the [releases page](https://github.com/coreybutler/nvm-windows/releases) for the most recent version.
+1. Follow the install instructions on the [nvm-windows repository](https://github.com/coreybutler/nvm-windows#installation--upgrades). We recommend using the installer, but if you have a more advanced understanding of your needs, you may want to consider the manual installation. The installer will point you to the [releases page](https://github.com/coreybutler/nvm-windows/releases) for the most recent version.
 2. Download the **nvm-setup.zip** file for the most recent release.
 3. Once downloaded, open the zip file, then open the **nvm-setup.exe** file.
 4. The Setup-NVM-for-Windows installation wizard will walk you through the setup steps, including choosing the directory where both nvm-windows and Node.js will be installed.
 
     ![NVM for Windows installation wizard](../../images/install-nvm-for-windows-wizard.png)
 
-5. Once the installation is complete. Open PowerShell (recommend opening with elevated Admin permissions) and try using windows-nvm to list which versions of Node are currently installed (should be none at this point): `nvm ls`
+5. Once the installation is complete. Open PowerShell (recommend opening with elevated Admin permissions) and try using nvm-windows to list which versions of Node are currently installed (should be none at this point): `nvm ls`
 
     ![NVM list showing no Node versions](../../images/windows-nvm-powershell-no-node.png)
 
@@ -58,13 +58,13 @@ Besides choosing whether to install on Windows or WSL, there are additional choi
 
 ### Alternative version managers
 
-While windows-nvm is currently the most popular version manager for node, there are alternatives to consider:
+While NVM for Windows (nvm-windows) is currently the most popular version manager for node, there are alternatives to consider:
 
 - [nvs](https://github.com/jasongin/nvs) (Node Version Switcher) is a cross-platform `nvm` alternative with the ability to [integrate with VS Code](https://github.com/jasongin/nvs/blob/master/doc/VSCODE.md).
 
 - [Volta](https://github.com/volta-cli/volta#installing-volta) is a new version manager from the LinkedIn team that claims improved speed and cross-platform support.
 
-To install Volta as your version manager (rather than windows-nvm), go to the **Windows Installation** section of their [Getting Started guide](https://docs.volta.sh/guide/getting-started), then download and run their Windows installer, following the setup instructions.
+To install Volta as your version manager, go to the **Windows Installation** section of their [Getting Started guide](https://docs.volta.sh/guide/getting-started), then download and run their Windows installer, following the setup instructions.
 
 > [!IMPORTANT]
 > You must ensure that [Developer Mode](/windows/uwp/get-started/enable-your-device-for-development#accessing-settings-for-developers) is enabled on your Windows machine before installing Volta.

hub/images/powertoys-workspaces/cli_args.png

@@ -1,7 +1,7 @@
 ---
 title: PowerToys Advanced Paste for Windows
 description: A tool that enables you to paste the text from your clipboard into any format needed. It can be enhanced with an AI-powered option that is 100% opt-in and requires an OpenAI key.
-ms.date: 11/19/2024
+ms.date: 12/13/2024
 ms.topic: concept-article
 no-loc: [PowerToys, Windows, Paste as Plain Text, Advanced Paste, Win]
 # Customer intent: Learn how to use the Advanced Paste feature in PowerToys to paste text from your clipboard into any format needed.
@@ -27,7 +27,8 @@ From the Settings menu, the following options can be configured:
 
 | Setting | Description |
 | :--- | :--- |
-| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/)). |
+| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/)). See [Paste text with AI](#paste-text-with-ai) for more information. |
+| Enable advanced AI | Enables the Advanced AI feature which allows [Semantic Kernel](/semantic-kernel/overview/) to be used to define a chain of actions to be performed when using "Paste with AI". See [Paste with Advanced AI](#paste-with-advanced-ai) for more information.<br/><br/>This setting is off and disabled when Enable Paste with AI is disabled. When enabling Enable Paste with AI, Enable advanced AI is also enabled by default, allowing users immediate access to the feature. |
 | Custom format preview | Enable to preview the output of the custom format before pasting. |
 | Clipboard history | Enable to automatically save clipboard history. |
 | Open Advanced Paste shortcut | The customizable keyboard command to open the **Advanced Paste** window. |
@@ -157,6 +158,27 @@ AI output when prompting to "Format the text as if it were written by Mark Twain
 > [!NOTE]
 > As with any AI tool, the quality of the output is dependent on the quality of the input. The more context you provide, the better the AI will be able to understand and respond to your request. Be sure to carefully review the output before using it. Please see OpenAI's [privacy](https://openai.com/policies/privacy-policy) and [terms](https://openai.com/policies/terms-of-use) pages for more info on AI usage in this feature.
 
+### Paste with Advanced AI
+
+This feature uses [Semantic Kernel](/semantic-kernel/overview/) to allow you to define a chain of actions to be performed when using "Paste with AI". Using this feature you can:
+
+- Work with non-text input such as images.
+- Produce non-text output like files.
+- Chain multiple actions together and execute them in sequence. For example, Image to text --> Text to JSON text --> JSON text to .txt file.
+- Produce meaningful AI-generated error messages.
+
+For these example commands, assume there is an image in the clipboard that contains some text that you would like to save to a text file in another language. You can phrase multiple steps explicitly:
+
+```
+Convert this image to text using OCR, translate the text to French, and then save the text as a .txt file.
+```
+
+Or you can phrase the steps to be more implicit:
+
+```
+Translate to French and save as a .txt file.
+```
+
 ## Advanced image paste
 
 Advanced Paste includes several image-based paste options. These options are available in the **Advanced Paste** window, which can be opened using the activation shortcut. You can optionally set a quick key shortcut in settings.

hub/images/powertoys-workspaces/post_capture_edit.png

@@ -1,7 +1,7 @@
 ---
 title: PowerToys Mouse utilities for Windows
 description: A collection of utilities to expand the range of usage for the mouse and cursor.
-ms.date: 11/19/2024
+ms.date: 12/13/2024
 ms.topic: concept-article
 ms.localizationpriority: medium
 no-loc: [PowerToys, Windows, Mouse, jump]
@@ -66,6 +66,8 @@ Mouse jump allows moving the mouse pointer long distances on a single screen or
 | Setting | Description |
 | :--- | :--- |
 | Activation shortcut | The customizable keyboard command to activate the mouse jump. |
+| Thumbnail Size | Constrains the thumbnail image to a maximum size. The default size is 1600x1200 pixels. |
+| Appearance | Expand this section to adjust the popup appearance by customizing the colors, borders, spacing, and more. |
 
 ## Mouse pointer Crosshairs
 

hub/powertoys/advanced-paste.md

@@ -25,7 +25,7 @@ With the dialog enabled, keep pressing your activation key.
 
 ## Character sets
 
-You can limit the available characters by selecting a character set from the settings menu. Available character sets are:
+You can limit the available characters by selecting character sets from the settings menu. Available character sets are:
 
 * Catalan
 * Currency
@@ -69,7 +69,7 @@ From the Settings menu, the following options can be configured:
 | Setting | Description |
 | :--- | :--- |
 | Activation key | Choose **Left/Right Arrow**, **Space** or **Left, Right or Space**. |
-| Character set | Show only characters that are in the chosen set. |
+| Character set | Show only characters that are in the chosen sets. |
 | Toolbar location | Position of the toolbar. |
 | Show the Unicode code and name of the currently selected character | Shows the Unicode code (in hexadecimal) and name of the currently selected character under the selector. |
 | Sort characters by usage frequency | |

hub/powertoys/mouse-utilities.md

@@ -272,6 +272,7 @@ The following GUID versions are supported:
 - v3 - Namespace and name based, using MD5
 - v4 - Random value
 - v5 - Namespace and name based, using SHA1
+- v7 - Time-ordered random value
 
 > [!NOTE]
 > For versions 3 and 5 there are some predefined namespaces: DNS, URL, OID and X500. You can use the following predefined namespaces:
@@ -288,6 +289,7 @@ Examples:
 | `# guid` <br />`# uuid` <br />`# uuidv4` | Generate a random GUID. |
 | `# guidv1` <br />`# uuidv1` | Generate a version 1 GUID. |
 | `# guidv3 ns:DNS www.microsoft.com` <br />`# uuidv3 ns:DNS www.microsoft.com` | Generate the GUID version 3 for `www.microsoft.com` using the DNS namespace. <br /> The namespace parameter can be any valid GUID, and the name parameter can be any string. |
+| `# uuid7` <br /> `# guidv7` | Generate a random version 7 GUID with the first 48-bit corresponding to the current timestamp, providing a well-defined order of subsequently generated values. |
 
 > [!TIP]
 > The `guid` and `uuid` keywords are interchangeable and the `v` is optional. I.e. `guid5` and `guidv5` are the same.