(#3446) (ENGTASKS-3631) Update GenerateDocs.ps1

[st3phhays]

Description Of Changes

The GenerateDocs.ps1 file has been modified to support the Astro framework that docs.chocolatey.org will be using.

• Frontmatter keys are lowercase
• import the Xref Component
• Switch links to use the Xref Component
• Ensure all code is within code blocks and not 4 spaces (.mdx does not recognize code blocks as 4 spaces)
• Ensure NOTE and WARNINGS are formatted correctly
• Update comments to use {/* stuff */} instead of <!-- stuff -->
• Change file format to .mdx

Motivation and Context

The documentation site has been switched to the Astro framework, and the changes here allow it to build.

Testing

1. Ran the GenerateDocs.ps1 file and copied the results into the docs repo.

Change Types Made

• [ ] Bug fix (non-breaking change).
• [ ] Feature / Enhancement (non-breaking change).
• [ ] Breaking change (fix or feature that could cause existing functionality to change).
• [x] Documentation changes.
• [ ] PowerShell code changes.

Change Checklist

• [ ] Requires a change to the documentation.
• [ ] Documentation has been updated.
• [ ] Tests to cover my changes, have been added.
• [ ] All new and existing tests passed?
• [ ] PowerShell code changes: PowerShell v2 compatibility checked?

Related Issue

Fixes #3446

• https://github.com/chocolatey/choco-theme/issues/405
• https://github.com/chocolatey/choco-astro/issues/1
• https://github.com/chocolatey/docs/issues/996
• https://github.com/chocolatey/choco/issues/3446
• https://gitlab.com/chocolatey/collaborators/choco-licensed/-/issues/712

[st3phhays]

This can be reviewed, but it may not be ready to merge until the Astro bits are ready to go into docs.

[st3phhays]

This can not be released until after this PR has been merged: https://github.com/chocolatey/docs/pull/993

The merging of this PR may require more changes to be made here, and changes to the files in the PR above might need to be fixed up to support Astro.

[gep13]

I am going to go ahead and merge this, since we don't need to wait on the CI builds passing.