Planning documentation release for 8.2 stable

[Arlodotexe]

Background

Windows Community Toolkit 8.2 is slated to release soon, with 8.2-preview2 already in flight.

When we create a new stable release, we make sure to update the documentation published on Microsoft Learn, which is sourced from here..

To generate these files from the interactive Markdown sample documentation we write in the gallery, we use the ./tooling/Build-Toolkit-Docs.ps1 script to transform between gallery-compatible and mslearn-compatible markdown.

Problem

To facilitate a smooth release, we need to ensure that the documentation we publish on Microsoft Learn is updated with the latest documentation from our repository.

Solution

Release refactored and improved documentation

• Use the ./tooling/Build-Toolkit-Docs.ps1 script to generate fresh sample docs
• Transfer the new docs over to our section of the MicrosoftDocs/CommunityToolkit repository.
• Ensure new docs added to the sample gallery are added to the docs repo.
• Ensure existing generated documents removed from the sample gallery are cleaned up in the docs repo.
• Ensure that TOC.yml is updated with added and removed pages. Add redirects as needed, the PR bot will assist with this.
• Ensure that index.md and TOC.yml and getting-started.md are preserved in the docs repo.

[michael-hawker]

We need to finish the migration of the mapping from the old docs: https://learn.microsoft.com/en-us/windows/communitytoolkit/ hosted in https://github.com/MicrosoftDocs/WindowsCommunityToolkitDocs - so that the old doc urls best get redirected to new ones and we can archive the old repository pointing to the new MicrosoftDocs/CommunityToolkit repo.

I think we also have some odd structure in the new docs due to how we copy/export the docs via the script, so that may be something to evaluate, though fixing would also require redirects.

[Arlodotexe]

We need to finish the migration of the mapping from the old docs: https://learn.microsoft.com/en-us/windows/communitytoolkit/ hosted in https://github.com/MicrosoftDocs/WindowsCommunityToolkitDocs - so that the old doc urls best get redirected to new ones and we can archive the old repository pointing to the new MicrosoftDocs/CommunityToolkit repo.

I think we also have some odd structure in the new docs due to how we copy/export the docs via the script, so that may be something to evaluate, though fixing would also require redirects.

We've already done a significant number of these, we need #602 to make further progress here.

For this ticket specifically, let's focus on what we can do for the 8.2 release this week and follow-up on this soon after. Especially since we can push smaller updates to docs at any time.

[Arlodotexe]

The generated Wiki-like sample docs for the 8.2 release were submitted here. The published documentation can be found here.