About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation is largely platform-neutral, focusing on ARM template best practices and JSON examples. However, there is a subtle Windows bias in the references to the ARM TTK (test toolkit) and its test cases, which are linked to PowerShell (.ps1) scripts and the toolkit's GitHub repository. The only explicit tool reference is to a .ps1 test case, suggesting PowerShell as the primary interface, which is Windows-centric. There are no explicit Linux/CLI/bash examples or instructions, nor are Linux equivalents mentioned alongside the PowerShell references.
Recommendations:
- When referencing the ARM TTK or its test cases, mention that the toolkit can be run cross-platform using PowerShell Core on Linux/macOS, or provide links to instructions for running it on non-Windows systems.
- Include CLI/bash examples or instructions where relevant, especially for running the toolkit or validating templates.
- When linking to .ps1 test cases or scripts, clarify that these can be executed on Linux/macOS with PowerShell Core, and provide guidance for Linux users.
- If there are any Linux-native tools or wrappers for ARM template validation, mention them alongside Windows/PowerShell options.
- Consider adding a 'Platform support' section that explicitly states the toolkit and guidance are cross-platform, and provide parity in instructions for both Windows and Linux users.
Create pull request