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_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by exclusively using Windows-style paths (e.g., c:\export), omitting Linux/macOS path examples, and referencing deployment steps and tools in a way that assumes a Windows environment. Both Azure PowerShell and Azure CLI examples use Windows file paths, and there is no mention of Linux/macOS equivalents or considerations.
Recommendations:
- Provide both Windows and Linux/macOS path examples in all CLI and PowerShell commands (e.g., c:\export and ~/export).
- Explicitly mention that Azure CLI and PowerShell are cross-platform, and show how to use them on Linux/macOS.
- Include notes or sections for Linux/macOS users, highlighting any differences in command usage or environment setup.
- Avoid assuming the use of Windows-only tools or patterns (such as backslashes in paths) in generic documentation.
- Where file system paths are referenced, use environment-agnostic variables or show both styles side by side.
Create pull request
Flagged Code Snippets
Export-AzTemplateSpec `
-ResourceGroupName demoRG `
-Name demoTemplateSpec `
-Version 1.0 `
-OutputFolder c:\export
az template-specs export \
--resource-group demoRG \
--name demoTemplateSpec \
--version 1.0 \
--output-folder c:\export
New-AzTemplateSpec `
-Name movedTemplateSpec `
-Version 1.0 `
-ResourceGroupName newRG `
-Location westus `
-TemplateJsonFile c:\export\1.0.json
az template-specs create \
--name movedTemplateSpec \
--version "1.0" \
--resource-group newRG \
--location "westus" \
--template-file "c:\export\demoTemplateSpec.json"