Documentation: Enhancements and adjustments to documentation

[oZakari]

Overview/Summary

General documentation enhancements and updates

Closes #764
Closes #765

This PR fixes/adds/changes/removes

This pull request primarily focuses on updating the documentation and instructions in several README files. It introduces recommendations for using the Bicep Landing Zone Vending Module instead of the current Spoke Networking Module, updates the method for deploying subnets, and adds instructions for registering the Microsoft.Insights resource provider in the Management subscription.

Here are the key updates:

Recommendation to use Bicep Landing Zone Vending Module:

• infra-as-code/bicep/modules/spokeNetworking/README.md: Added a recommendation to use the Bicep Landing Zone Vending Module instead of the current Spoke Networking Module.
• infra-as-code/bicep/orchestration/hubPeeredSpoke/README.md: Similar recommendation added here.

Updates to deployment instructions:

• infra-as-code/bicep/modules/mgDiagSettings/README.md: Updated the deployment commands for Azure global regions and Azure China regions. The commands now use variables for better readability and maintainability.

Subnet deployment method update:

• infra-as-code/bicep/modules/spokeNetworking/README.md: Updated the recommended method for deploying subnets from CARML to AVM (Azure Verified Modules).

Registration of Microsoft.Insights resource provider:

• infra-as-code/bicep/orchestration/mgDiagSettingsAll/README.md: Added a PowerShell script for checking and registering the Microsoft.Insights resource provider in the Management subscription.

Breaking Changes

None

Testing Evidence

Replace this with any testing evidence to show that your Pull Request works/fixes as described and planned (include screenshots, if appropriate).

As part of this Pull Request I have

• Read the Contribution Guide and ensured this PR is compliant with the guide
• Ensured the resource API versions in .bicep file/s I am adding/editing are using the latest API version possible
• Checked for duplicate Pull Requests
• Associated it with relevant GitHub Issues
• (ALZ Bicep Core Team Only) Associated it with relevant ADO Items
• Ensured my code/branch is up-to-date with the latest changes in the main branch
• Performed testing and provided evidence.
• Updated one or more of the following tests (if required)
  • Unit
  • Linting
  • E2E (End-To-End)
  • ValidateAzCloud (Base validation in Azure Cloud)
  • ValidateMcCloud (Base validation in Azure China Cloud)
• Updated relevant and associated documentation (e.g. Contribution Guide, Module READMEs, Wiki Docs etc.)
• If relevant, created or updated Code Tours here