Add initial docs for value generator.

Author: IHorvalds

hub/powertoys/run.md

@@ -30,6 +30,8 @@ PowerToys Run features include:
 - Execute system commands
 - Get time and date information
 - Convert units
+- Calculate hashes
+- Generate GUIDs
 - Open web pages or start a web search
 
 ## Settings
@@ -89,6 +91,7 @@ The plugins can be activated with a direct activation command so that PowerToys
 | Time and date| `)` | `) time and date` shows the current time and date in different formats.<br />`) calendar week::04/01/2022` shows the calendar week for the date '04/01/2022'. |
 | Time zones | `&` | `& Newfoundland` shows the current time in the time zone of Newfoundland. |
 | Unit converter | `%%` | `%% 10 ft in m` to calculate the number of meters in 10 feet. |
+| Value Generator | `#` | `# guid3 ns:URL www.microsoft.com` to generate the GUIDv3 for the URL namespace using the URL namespace. <br />`# sha1 abc` to calculate the SHA1 hash for the string 'abc'. |
 | URI-handler | `//` | `//` to launch your default browser.<br />`// learn.microsoft.com` to have your default browser go to Microsoft Learn.<br />`mailto:` and `ms-settings:` links are supported. |
 | Visual Studio Code | `{` | `{ powertoys` to search for previously opened workspaces, remote machines and containers that contain 'powertoys' in their paths. |
 | Web search | `??` | `??` to launch your default browser's search page.<br />`?? What is the answer to life` to search with your default browser's search engine. |
@@ -258,6 +261,38 @@ The Unit Converter plugin supports the following unit types:
 - Temperature
 - Volume
 
+### Value Generator plugin
+
+The value generator plugin can generate GUIDs/UUIDs and calculate hashes.
+
+It supports the following GUID versions:
+- v1 - Time based
+- v3 - Namespace and name based, using MD5
+- v4 - Random value
+- v5 - Namespace and name based, using SHA1
+
+> [!NOTE]
+> For versions 3 and 5 there are some predefined namespaces: DNS, URL, OID ad X500. You can use the following shortcuts:
+> `ns:DNS`, `ns:URL`, `ns:OID`, `ns:X500`.
+
+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. The namespace parameter can be any valid GUID and the name parameter can be any string
+
+> [!NOTE]
+> The `guid` and `uuid` keywords are interchangeable and the `v` is optional. I.e. `guid5` and `guidv5` are the same.
+
+It also supports the following hashing algorithms:
+- MD5
+- SHA1
+- SHA256
+- SHA384
+- SHA512
+
+Usage:
+- `# md5 abc`: The string to be hashed cannot contain multiple consecutive spaces between 2 non-whitespace characters. They will be converted to a single space. I.e. 'a  a' will be converted to 'a a' before being hashed.
+
 ### Folder search filters
 
 In the Folder plugin you can filter the results by using some special characters.