Document Details
Template Tutorial Create First Template
❌
This page contains Windows bias
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
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation provides both Azure PowerShell and Azure CLI (Bash) examples for deployment, but there is a subtle Windows bias. PowerShell is consistently listed first in code tabs and instructions, and there are explicit references to Windows-centric tools and workflows (e.g., Visual Studio Code, Windows file paths, and specific notes about running CLI commands in Windows PowerShell or Command Prompt). Installation instructions for Azure CLI list Windows before Linux and macOS. There are no Linux-specific editor or shell recommendations, and the overall tone assumes familiarity with Windows environments.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to reflect its cross-platform nature.
- Add explicit instructions or tips for Linux/macOS users, such as using editors like VS Code, Vim, or Nano, and handling file paths.
- Include notes about running Azure CLI in native Linux/macOS terminals, not just Bash on Windows.
- Provide parity in screenshots and examples (e.g., show both Windows and Linux terminal outputs where relevant).
- Avoid language that assumes a Windows environment (e.g., 'workstation', 'Command Prompt') and use more neutral terms.
- Mention cross-platform alternatives for tools and clarify that all steps work equally on Linux/macOS.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-12 00:58 | #8 | cancelled | ✅ Clean |
| 2025-07-10 05:06 | #7 | processing | ✅ Clean |
Flagged Code Snippets
Connect-AzAccount
Set-AzContext SubscriptionName
New-AzResourceGroup `
-Name myResourceGroup `
-Location "Central US"
$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
-Name blanktemplate `
-ResourceGroupName myResourceGroup `
-TemplateFile $templateFile