Added warning about the usage of the custom schema

[pictos]

Description of Change

Added more info about the usage of the custom schema xmlns.

Linked Issues

• Related to #427

PR Checklist

• [ ] Has a linked Issue, and the Issue has been approved(bug) or Championed (feature/proposal)
• [ ] Has tests (if omitted, state reason in description)
• [ ] Has samples (if omitted, state reason in description)
• [ ] Rebased on top of main at time of PR
• [ ] Changes adhere to coding standard
• [ ] Documentation created or updated: https://github.com/MicrosoftDocs/CommunityToolkit/pull/XYZ

Additional information

[bijington]

Thanks @pictos I really like the idea! I would like us to provide some information around the differences between using a library and app project and give an example of how to overcome it, perhaps this should go in the NuGet read me file too.

I'm hoping to watch that video on the subject so I have a better understanding before I make some full suggestions though.

[pictos]

@brminnick how do you feel about merging this and creating an issue to use an SG to fix the issue? If you go on our discord channel, you'll see some points that we need to test and make sure that SG will work as expected.

[bijington]

@brminnick how do you feel about merging this and creating an issue to use an SG to fix the issue? If you go on our discord channel, you'll see some points that we need to test and make sure that SG will work as expected.

If we do merge I would like to reword it a bit to make it a little bit more helpful in guiding developers on how to workaround the issue.

[pictos]

@bijington do you have something in mind already? If so feel free to push the changes to this PR

[bijington]

@bijington do you have something in mind already? If so feel free to push the changes to this PR

Yeah I can happily provide something on this

[bijington]

Sorry I should add my content to this! I'll try and do that this weekend

[TheCodeTraveler]

.UseMauiCommunityToolkit() Analyzer added in #486

[pictos]

@brminnick should we close this? Or still is good to have this in some "docs"?

[TheCodeTraveler]

I'd like to add implement two more things to the code base before we close this:

1. A CommunityToolkit.Maui.Init() method that a user can call from a class library

• This provides a work-around for devs using the .NET MAUI Community Toolkit in a class library to "initialize" the Toolkit
• The method wouldn't actually do anything (eg it wouldn't wire-up handlers), but it ensures that they have written C# code from CommunityToolkit.Maui and the custom schema will not fail

2. An analyzer that verifies a developer has called CommunityToolkit.Maui.Init() in their class library

public static void Init()
{
  
}

Having this PR open is a good reminder that we still need to do it!

[TheCodeTraveler]

Superseded by https://github.com/CommunityToolkit/Maui/pull/486