Description
Summary of the new feature/enhancement
PowerToys has many tools which have complicated terminology or certain "not-straightforward" concepts. Most of these things can become clear to the user by taking a look at the Readme, but going to the current "Module overview" link isn't the first thing a user would do if they get frustrated with some terminology or understanding how to use the tool. They might just uninstall instead.
Inspired by the fact that KBM has complicated terminology and users need to know what are valid shortcuts and things like that, having warnings is not enough, and certain things will have to be clarified using the Readme. With the migration to Fluent UI, what if instead of expecting the users to go to the readme when they are facing issues we use WinUI teaching tips instead by detecting when users are stuck on something. The teaching tip could either just provide more information, or an easier more noticeable solution would be to redirect the user to the readme.
Imagine the text in the teaching tip in the image below as "Confused with the terminology? Check out the documentation to clear things up." which would link to the Readme.
This idea actually reminds me a lot of PaperClip. It could also have some buttons for Dismiss, or Never Show Again so that a well versed user doesn't need to deal with annoying pop ups.
Proposed technical implementation details (optional)
For Keyboard Manager a scenario that can be implemented easily would be that a user tries remapping shortcuts and encounters say "10" warnings or they have stayed on the window for X minutes without getting a successful remap, we can show a little teaching tip on the side which would redirect the user to the readme. Teaching tips as shown in the screenshot earlier are a WinUI feature which means implementation should be straight forward too.
Activity