Skip to content

Fix misleading executable path placeholder and add schema warning note in toast/snackbar setup docs#635

Merged
jfversluis merged 2 commits intomainfrom
copilot/fix-warnings-from-directions
Mar 17, 2026
Merged

Fix misleading executable path placeholder and add schema warning note in toast/snackbar setup docs#635
jfversluis merged 2 commits intomainfrom
copilot/fix-warnings-from-directions

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 17, 2026

The Windows setup instructions for Toast/Snackbar use YOUR-PATH-TO-EXECUTABLE without explaining how to determine the value, and users encounter an rescap:Capability schema validation warning with no guidance.

  • Replaced placeholder YOUR-PATH-TO-EXECUTABLEYOUR-PROJECT-NAME\YOUR-PROJECT-NAME.exe with an [!IMPORTANT] callout explaining the format:

    {.csproj file name without extension}\{.csproj file name without extension}.exe
    

    e.g., MyMauiApp.csprojMyMauiApp\MyMauiApp.exe (matches the pattern used in the actual sample app)

  • Added [!NOTE] that the rescap:Capability XML schema validation warning in Visual Studio is a false positive and safe to ignore

Both toast.md and snackbar.md include this shared file (toast-snackbar-setup.md), so both pages are fixed.

Original prompt

This section details on the original issue you should resolve

<issue_title>Following Directions Leads to Warnings</issue_title>
<issue_description>### Type of issue

Missing information

Description

Following the directions provided I get two warnings:

The element 'Capabilities' in namespace 'http://schemas.microsoft.com/appx/manifest/foundation/windows10' has invalid child element 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities'. List of possible elements expected: 'CapabilityChoice' in namespace 'http://schemas.microsoft.com/appx/manifest/foundation/windows10' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/foundation/windows10' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10/4' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10/11' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10/2' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10/6' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10/7' as well as 'Capability' in namespace 'http://schemas.microsoft.com/appx/manifest/uap/windows10/3' as well as 'CustomCapabilityChoice' in namespace 'http://schemas.microsoft.com/appx/manifest/foundation/windows10' as well as 'CustomCa....
The 'Executable' attribute is invalid - The value 'YOUR-PATH-TO-EXECUTABLE' is invalid according to its datatype 'http://schemas.microsoft.com/appx/manifest/types:ST_ExecutableAnyCase' - The Pattern constraint failed.

The document does not mention YOUR-PATH-TO-EXECUTABLE except for the code it refers to copy/paste, or how to determine it.

Page URL

https://learn.microsoft.com/en-us/dotnet/communitytoolkit/maui/alerts/toast?tabs=windows%2Candroid

Content source URL

https://github.com/MicrosoftDocs/CommunityToolkit/blob/main/docs/maui/alerts/toast.md

Document Version Independent Id

8536c827-5a35-ebdd-51fd-0a184bfe1d69

Platform Id

c1e8a685-717d-0e87-f2d2-8c76d3281b2a

Article author

@VladislavAntonyuk

Metadata

  • ID: 8536c827-5a35-ebdd-51fd-0a184bfe1d69
  • PlatformId: c1e8a685-717d-0e87-f2d2-8c76d3281b2a
  • Service: dotnet-communitytoolkit
  • Sub-service: dotnet-maui-community-toolkit</issue_description>

Comments on the Issue (you are @copilot in this section)


🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

@learn-build-service-prod
Copy link
Copy Markdown

Learn Build status updates of commit 5f10f4c:

⚠️ Validation status: warnings

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

…ning note

Replace unclear YOUR-PATH-TO-EXECUTABLE with YOUR-PROJECT-NAME\YOUR-PROJECT-NAME.exe
and add an explanation of how to determine the correct value. Also add a note
that the rescap:Capability schema validation warning is safe to ignore.

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix warnings caused by following directions Fix misleading executable path placeholder and add schema warning note in toast/snackbar setup docs Mar 17, 2026
Copilot AI requested a review from jfversluis March 17, 2026 08:39
@learn-build-service-prod
Copy link
Copy Markdown

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Copy Markdown

Learn Build status updates of commit a95bd2a:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/includes/toast-snackbar-setup.md ✅Succeeded View

For more details, please refer to the build report.

@jfversluis jfversluis marked this pull request as ready for review March 17, 2026 08:55
@jfversluis jfversluis merged commit 0413b46 into main Mar 17, 2026
3 checks passed
@jfversluis jfversluis deleted the copilot/fix-warnings-from-directions branch March 17, 2026 09:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Following Directions Leads to Warnings

3 participants