PowerToys/doc/devdocs/commands.md
Noraa Junker cffdecbc1b
Add documentation of bot commands and fix some devdocs (#43399)
<!-- Enter a brief description/summary of your PR here. What does it
fix/what does it change/how was it tested (even manually, if necessary)?
-->
## Summary of the Pull Request

* Fixes location of `style.md` file
* Deletes duplicated `localization.md` file
* Adds documentation about the bot commands.
* Adds links to aka.ms link docs and the new document

<!-- Please review the items on the PR checklist before submitting-->
## PR Checklist

- [ ] Closes: #xxx
- [ ] **Communication:** I've discussed this with core contributors
already. If the work hasn't been agreed, this work might be rejected
- [x] **Dev docs:** Added/updated
2025-12-05 14:55:45 +01:00

2.7 KiB

Issue/PR commands

The PowerToys repository uses some special keywords to help manage issues and pull requests. Here is a list of the most important commands you can use in issue and PR descriptions or comments.

Command Description
/azp run Triggers the Azure Pipelines CI build for the current PR. Useful if you want to re-run the build without creating a new commit.
/bugreport / /reportbug Adds a comment with a manual for the Bug Report Tool, which helps users collect logs and system information for debugging purposes. It requests to upload this file and adds the Needs-Author-Feedback label.
/feedbackhub Adds a comment with a link to the Feedback Hub app on Windows, where users can submit feedback about PowerToys. Closes the issue and adds the Resolution-Please File on Feedback Hub label.
/dup #... / /duplicate #... / /dup https://... / /duplicate https://... Marks the current issue as a duplicate of another issue. It closes the current issue and applies the Resolution-Duplicate label. Replace #... with the issue number or a link to the issue.
/needinfo Adds the Needs-Author-Feedback label to the issue or PR, indicating that more information is needed from the author.
/helped Closes the issue and adds the Resolution-Helped User label. Furthermore a comment is added with a link to the PowerToys user documentation.
/loc Adds a comment informing the user that the issue was forwarded to the localization team and will soon be fixed. It adds the Loc-Sent To Team label.

Defining new commands

Most of these commands are using the Microsoft GitHub Policy Service bot. Its commands are defined in the PowerToys policy configuration file.

Other automated tasks

Automatic labeling

The bot can automatically apply the correct product-... label for any opened issue.

Note

This feature is currently only available for the Workspaces module as a test.

The Needs-Author-Feedback label

If an issue has this label and had no activity for 5 days, the bot will post a comment reminding the author to provide the needed information. It also adds the Status-No recent activity label. If no further activity occurs for another 5 days, the bot will close the issue.

Filtering users that want to contribute

If a user utters their intention to contribute (e.g., by using the phrase "I want to contribute" in an issue or PR), the bot will add a comment with a link to the "Would you like to contribute to PowerToys?" thread.