Skip to content

Commit 36f9761

Browse files
Merge pull request #4558 from Jay-o-Way/PT-updates
General brush up of PowerToys docs
2 parents 499baee + 399448b commit 36f9761

27 files changed

+359
-387
lines changed

hub/apps/whats-new/latest-doc-updates.md

Lines changed: 23 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -18,54 +18,50 @@ For the latest Windows Developer Documentation news, or to reach out to us with
1818

1919
Don't forget to visit the [Windows Developer Center](https://developer.microsoft.com/windows/), where we highlight some of the latest technologies, frameworks and news for Windows developers.
2020

21-
*Many thanks to everyone who has contributed to the documentation. Your corrections and suggestions are very welcome! For information on contributing, please see our [contributor guide](/contribute/).*
21+
_Many thanks to everyone who has contributed to the documentation. Your corrections and suggestions are very welcome! For information on contributing, please see our [contributor guide](/contribute/)._
2222

2323
Highlights this month include:
2424

2525
## Microsoft Build announcements for Windows developers
2626

2727
* [Dev Home](/windows/dev-home/): Monitor your work in the centralized dashboard, GitHub and System performance widgets. Get setup and onboard new projects with the Machine configuration tool. Learn about Dev Home’s:
28-
* [Dashboard widgets](/windows/dev-home/), including the ability to set up customized GitHub feeds,
29-
* [Machine configuration tool](/windows/dev-home/setup) for setting up a new machine or onboard a new project, and
30-
* [Customizable extensions](/windows/dev-home/extensions), with the ability to set up GitHub notifications or build and share your own Open Source extension for Dev Home.
28+
* [Dashboard widgets](/windows/dev-home/), including the ability to set up customized GitHub feeds,
29+
* [Machine configuration tool](/windows/dev-home/setup) for setting up a new machine or onboard a new project, and
30+
* [Customizable extensions](/windows/dev-home/extensions), with the ability to set up GitHub notifications or build and share your own Open Source extension for Dev Home.
3131

32-
* [Dev Drive](/windows/dev-drive/): Improve your dev workload performance using this new storage format, using ReFS and specifically designed for developer scenarios, with the ability to designate trust, manage antivirus configurations, and attach security filters.
33-
* Microsoft Defender has a new [performance mode](/microsoft-365/security/defender-endpoint/microsoft-defender-endpoint-antivirus-performance-mode?view=o365-worldwide) specifically designed for Dev Drive.
32+
* [Dev Drive](/windows/dev-drive/): Improve your dev workload performance using this new storage format, using ReFS and specifically designed for developer scenarios, with the ability to designate trust, manage antivirus configurations, and attach security filters.
33+
* Microsoft Defender has a new [performance mode](/microsoft-365/security/defender-endpoint/microsoft-defender-endpoint-antivirus-performance-mode?view=o365-worldwide) specifically designed for Dev Drive.
3434

35-
* [WinGet Configuration](/windows/package-manager/configuration/): Consolidate manual machine setup and project onboarding to a single command that is reliable and repeatable. Learn how to:
36-
* [Author a WinGet Configuration file](/windows/package-manager/configuration/create),
37-
* [Check the trustworthiness of a WinGet Configuration file](/windows/package-manager/configuration/check),
38-
* [Use the winget configure command](/windows/package-manager/winget/configure) to begin setting up your machine to the desired configuration state.
35+
* [WinGet Configuration](/windows/package-manager/configuration/): Consolidate manual machine setup and project onboarding to a single command that is reliable and repeatable. Learn how to:
36+
* [Author a WinGet Configuration file](/windows/package-manager/configuration/create),
37+
* [Check the trustworthiness of a WinGet Configuration file](/windows/package-manager/configuration/check),
38+
* [Use the winget configure command](/windows/package-manager/winget/configure) to begin setting up your machine to the desired configuration state.
3939

40-
* [PowerToys](/windows/powertoys/): These open source utilities are suggested by and developed with the help of the developer community using Windows. New utilities in the .70 release include:
41-
* [Mouse without Borders](/windows/powertoys/mouse-without-borders), for seamless transition between multiple machines from the same keyboard and mouse, sharing clipboard contents and files,
42-
* [Peek](/windows/powertoys/peek), for previewing file content without the need to open multiple apps or interrupt your workflow,
43-
* [Paste as Plain Text](/windows/powertoys/paste-as-plain-text), for pasting text from your clipboard, excluding any text-formatting.
40+
* [PowerToys](/windows/powertoys/): These open source utilities are suggested by and developed with the help of the developer community using Windows. New utilities in the .70 release include:
41+
* [Mouse without Borders](/windows/powertoys/mouse-without-borders), for seamless transition between multiple machines from the same keyboard and mouse, sharing clipboard contents and files,
42+
* [Peek](/windows/powertoys/peek), for previewing file content without the need to open multiple apps or interrupt your workflow,
43+
* [Paste as Plain Text](/windows/powertoys/paste-as-plain-text), for pasting text from your clipboard, excluding any text-formatting.
4444

45-
* [Windows Terminal](/windows/terminal/): Customize your terminal and running multiple command lines, all set up to their specific preferences. Learn more about how to customize your prompt and the new Tab Tearout feature.
45+
* [Windows Terminal](/windows/terminal/): Customize your terminal and running multiple command lines, all set up to their specific preferences. Learn more about how to customize your prompt and the new Tab Tearout feature.
4646

47-
* [Windows Copilot](/windows/dev-environment/): The first PC platform to provide centralized AI assistance and designed to help people easily take action and get things done is coming soon!
48-
49-
* [Windows on Arm](/windows/arm/overview): We’ve got a new tutorial that can help you update your apps to run natively on Arm.
47+
* [Windows Copilot](/windows/dev-environment/): The first PC platform to provide centralized AI assistance and designed to help people easily take action and get things done is coming soon!
5048

49+
* [Windows on Arm](/windows/arm/overview): We’ve got a new tutorial that can help you update your apps to run natively on Arm.
5150

5251
<hr>
5352

54-
5553
The following list of topics have also seen significant updates in the past month:
5654

5755
## Windows App SDK / WinUI
5856

5957
* [WinAppSDK 1.4 Experimental Release Notes](/windows/apps/windows-app-sdk/experimental-channel)
6058

61-
6259
## Code samples, tutorials and Learn Module updates
6360

64-
* Added [examples page for a new Win32 bindlink.h header](/windows/win32/bindlink/bindlink-example).
65-
* Added [examples page for a new Win32 hwreqchkapi.h header](/windows/win32/hwreqchkapi/hwreqchk-examples), including four code examples.
66-
* Rust: Fixed the code sample in [RSS reader tutorial](/windows/dev-environment/rust/rss-reader-rust-for-windows).
67-
* C++/WinRT: Updated [A completion source sample](/windows/uwp/cpp-and-winrt-apis/concurrency-3).
68-
61+
* Added [examples page for a new Win32 bindlink.h header](/windows/win32/bindlink/bindlink-example).
62+
* Added [examples page for a new Win32 hwreqchkapi.h header](/windows/win32/hwreqchkapi/hwreqchk-examples), including four code examples.
63+
* Rust: Fixed the code sample in [RSS reader tutorial](/windows/dev-environment/rust/rss-reader-rust-for-windows).
64+
* C++/WinRT: Updated [A completion source sample](/windows/uwp/cpp-and-winrt-apis/concurrency-3).
6965

7066
## Updated content
7167

@@ -75,18 +71,13 @@ The following list of topics have also seen significant updates in the past mont
7571
* [Use the Windows App SDK in a WPF app](/windows/apps/windows-app-sdk/wpf-plus-winappsdk)
7672
* [Win2D](/windows/apps/develop/win2d/) content migrated from GitHub
7773

78-
7974
## Developer tool updates
8075

8176
* [Windows Subsystem for Linux, Enterprise and Security Control Options](/windows/wsl/enterprise).
8277
* [Windows Subsystem for Android updates](/windows/android/wsa/).
8378
* [Windows Package Manager updates](/windows/package-manager/).
8479
* [PowerToys](/windows/powertoys/install).
8580

86-
87-
88-
89-
9081
## Win32 Conceptual
9182

9283
* [LVM_ENABLEGROUPVIEW message (Commctrl.h)](/windows/desktop/Controls/lvm-enablegroupview)
@@ -154,6 +145,7 @@ The following list of topics have also seen significant updates in the past mont
154145
* [STRINGTABLE resource](/windows/desktop/menurc/stringtable-resource)
155146

156147
## Win32 API reference
148+
157149
* [Data Access and Storage](/windows/win32/api/_fs/index)
158150
* [Human Interface Devices Reference](/windows/win32/api/_hid/index)
159151
* [Hardware Requirement Evaluator (HWREQCHK)](/windows/win32/api/_hwreqchk/index)
@@ -195,4 +187,4 @@ The following list of topics have also seen significant updates in the past mont
195187
* [Windows.UI.Shell.WindowTabGroup.Title](/uwp/api/windows.ui.shell.windowtabgroup.title)
196188
* [Windows.UI.Shell.WindowTabIcon](/uwp/api/windows.ui.shell.windowtabicon)
197189
* [Windows.UI.Shell.WindowTabManager](/uwp/api/windows.ui.shell.windowtabmanager)
198-
* [Windows.UI.Shell.WindowTabManager.Tabs](/uwp/api/windows.ui.shell.windowtabmanager.tabs)
190+
* [Windows.UI.Shell.WindowTabManager.Tabs](/uwp/api/windows.ui.shell.windowtabmanager.tabs)

hub/dev-environment/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -131,10 +131,10 @@ items:
131131
href: ../powertoys/registry-preview.md
132132
- name: PowerToys Run
133133
href: ../powertoys/run.md
134-
- name: Shortcut Guide
135-
href: ../powertoys/shortcut-guide.md
136134
- name: Screen Ruler
137135
href: ../powertoys/screen-ruler.md
136+
- name: Shortcut Guide
137+
href: ../powertoys/shortcut-guide.md
138138
- name: Text Extractor
139139
href: ../powertoys/text-extractor.md
140140
- name: Video Conference Mute

hub/powertoys/administrator.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
---
22
title: PowerToys administrator mode for Windows
33
description: For PowerToys to work with an app running in elevated admin mode, PowerToys must be running in administrator mode as well.
4-
ms.date: 04/19/2023
4+
ms.date: 08/03/2023
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones]
88
---
99

1010
# PowerToys running with administrator permissions
1111

12-
If you're running any application as an administrator (also referred to as elevated permissions), PowerToys may not work correctly when the elevated applications are in focus or trying to interact with a PowerToys feature like FancyZones. This can be addressed by also running PowerToys as an administrator.
12+
When running any application as an administrator (also referred to as elevated permissions), PowerToys may not work correctly when the elevated applications are in focus or trying to interact with a PowerToys feature like FancyZones. This can be addressed by also running PowerToys as administrator.
1313

1414
## Options
1515

1616
There are two options for PowerToys to support applications running as administrator (with elevated permissions):
1717

18-
1. **Recommended**: PowerToys will display a prompt when an elevated process is detected. Open PowerToys Settings. Inside the General page, select <kbd>Restart as administrator</kbd>.
18+
1. **Recommended**: PowerToys will display a notification when an elevated process is detected. Open PowerToys Settings. On the General tab, select **Restart as administrator**.
1919
2. Enable **Always run as administrator** in the PowerToys Settings.
2020

2121
## Support for admin mode with PowerToys
2222

23-
PowerToys needs elevated administrator permission when editing protected system settings or when interacting with other applications that are running in administrator mode. If those applications are in focus, PowerToys may not function unless it is elevated as well.
23+
PowerToys needs elevated administrator permission when writing protected system settings or when interacting with other applications that are running in administrator mode. If those applications are in focus, PowerToys may not function unless it is elevated as well.
2424

2525
These are the two scenarios PowerToys will not work in:
2626

@@ -53,11 +53,9 @@ Admin mode permissions may be required in the following scenarios:
5353

5454
## Run as administrator: elevated processes explained
5555

56-
Windows applications run in _User mode_ by default. To run an application in _Administrative mode_ or as an _elevated process_ means that app will run with additional access to the operating system.
56+
Windows applications run in _User mode_ by default. To run an application in _Administrative mode_ or as an _elevated process_ means that app will run with additional access to the operating system. Most apps do not need to run with elevated permission. A common scenario, however, for requiring administrator permission would be to run certain PowerShell commands or edit the registry.
5757

58-
The simplest way to run an app or program in administrative mode is to right-click the program and select <kbd>Run as administrator</kbd>. If the current user is not an administrator, Windows will ask for the administrator username and password.
59-
60-
Most apps do not need to run with elevated permission. A common scenario, however, for requiring administrator permission would be to run certain PowerShell commands or edit the registry.
58+
The simplest way to run an app or program in administrative mode is to right-click the program and select **Run as administrator**. If the current user is not an administrator, Windows will ask for the administrator username and password.
6159

6260
If you see this User Account Control prompt, the application is requesting administrator level elevated permission:
6361

hub/powertoys/always-on-top.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: PowerToys Always on Top utility for Windows
33
description: A system-wide utility for Windows that allows you to pin windows to the top of your screen.
4-
ms.date: 04/19/2023
4+
ms.date: 08/03/2023
55
ms.topic: article
66
no-loc: [PowerToys, Windows, Always on Top, Win]
77
---
88

99
# Always on Top utility
1010

11-
A system-wide utility for Windows that allows you to pin windows to the top of all your windows.
11+
A system-wide utility for Windows to pin windows above other windows.
1212

1313
![AlwaysOnTop screenshot.](../images/pt-always-on-top.png)
1414

@@ -18,7 +18,7 @@ With the activation / deactivation shortcut (default: <kbd>⊞ Win</kbd>+<kbd>Ct
1818

1919
## Settings
2020

21-
From the Settings menu, the following options can be configured:
21+
From the Settings tab, you can configure the following options:
2222

2323
| Setting | Description |
2424
| :--- | :--- |

hub/powertoys/awake.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,45 @@
11
---
22
title: PowerToys Awake utility for Windows
33
description: A tool for a Windows computer to stay awake.
4-
ms.date: 05/05/2023
4+
ms.date: 08/03/2023
55
ms.topic: article
66
ms.localizationpriority: medium
77
---
88

99
# PowerToys Awake utility
1010

11-
PowerToys Awake is a utility tool for Windows designed to keep a computer awake without having to manage its [power & sleep settings](https://support.microsoft.com/windows/how-to-adjust-power-and-sleep-settings-26f623b5-4fcc-4194-863d-b824e5ea7679). This behavior can be helpful when running time-consuming tasks, ensuring that the computer does not go to sleep or turn off its screens.
11+
PowerToys Awake is a tool for Windows designed to keep a computer awake without having to manage its [power & sleep settings](https://support.microsoft.com/windows/how-to-adjust-power-and-sleep-settings-26f623b5-4fcc-4194-863d-b824e5ea7679). This can be helpful when running time-consuming tasks, ensuring that the computer does not go to sleep or turn off its screens.
1212

1313
## Getting started
1414

15-
PowerToys Awake can be used directly from PowerToys Settings or as a standalone executable. When the tool is running from PowerToys, it can be managed from PowerToys Settings or the system tray.
15+
You can use PowerToys Awake directly from PowerToys Settings or as a standalone executable. When it's running from PowerToys, it can be managed from PowerToys Settings or the system tray.
1616

1717
> [!NOTE]
1818
> PowerToys Awake does not modify any of the Windows power plan settings, and does not depend on a custom power plan configuration. Instead, it spawns background threads that tell Windows that they require a specific state of the machine.
1919
2020
## Settings
2121

22-
In the PowerToys Settings view, start PowerToys Awake by using the **Enable Awake** toggle. Once enabled, the application will manage the awakeness state of the computer.
22+
In the PowerToys Settings, start PowerToys Awake by toggling **Enable Awake** on. Once enabled, the application will manage the awakeness state of the computer.
2323

2424
![A screenshot of the Awake settings.](../images/pt-awake-settings-menu.png)
2525

26-
The following Awake states can be selected:
26+
You can choose the following Awake states:
2727

2828
| Setting | Description |
2929
| :-- | :-- |
3030
| Keep using the selected power plan | The computer awakeness state is unaffected. The application is waiting for user input. |
31-
| Keep awake indefinitely | The computer stays awake indefinitely, until you explicitly put the machine to sleep or exits/disables the application. |
32-
| Keep awake for a time interval | Keep machine awake for a defined limited time. After the defined time Awake returns to the previous state. |
31+
| Keep awake indefinitely | The computer stays awake indefinitely, until you explicitly put the machine to sleep or close/disable the application. |
32+
| Keep awake for a time interval | Keep machine awake for a defined limited time. After the defined time, Awake returns to the previous state. |
3333
| Keep awake until expiration. | Keep machine awake until a defined time. |
3434

3535
> [!NOTE]
3636
> Changing the hours or minutes while the computer is kept awake temporarily will reset the timer.
3737
3838
### Keep screen on
3939

40-
While PowerToys Awake can keep the computer awake indefinitely or temporarily, in its default state the displays connected to the machine will turn off, even though the computer won't go to sleep. If you need the displays to be available, use the **Keep screen on** switch, which will ensure that all monitors remain on.
40+
While PowerToys Awake can keep the computer awake indefinitely or temporarily, in its default state the displays connected to the machine will turn off. If you need the displays to be available, use the **Keep screen on** switch, which will keep displays active.
4141

42-
This feature only works if Awake is running in one of the three `Keep awake` state.
42+
This feature only works if Awake is running in one of the three **Keep awake** states.
4343

4444
## System tray
4545

@@ -54,7 +54,7 @@ PowerToys Awake can also be executed as a standalone application, directly from
5454
| Argument | Description |
5555
| :---------------- | :---------- |
5656
| `--use-pt-config` | Use the PowerToys configuration file to manage the settings. This assumes that there is a `settings.json` file for Awake, generated by PowerToys, that contains all required runtime information. This includes the Behavior Mode (indefinite or timed), whether screens should be kept on, and what the values for hours and minutes are for a temporary keep-awake.<br/>When this argument is used, all other arguments are ignored. Awake will look for changes in the `settings.json` file to update its state. |
57-
| `--display-on` | Determines whether the screens should be kept on or off while the machine is kept awake. Expected values are `true` or `false`. |
57+
| `--display-on` | Keep displays on or off while the machine is kept awake. Expected values are `true` or `false`. |
5858
| `--time-limit` | Duration, in seconds, during which Awake keeps the computer awake. Can be used in combination with `--display-on`. |
5959
| `--expire-at` | Expiration date and/or time when Awake will turn off and resume the standard power state. Can be used in combination with `--display-on`. |
6060
| `--pid` | Attaches the execution of Awake to a Process ID (PID). When the process with a given PID terminates, Awake terminates as well. |

0 commit comments

Comments
 (0)