Document Details
Template Specs Create Linked
❌
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
⚠️
missing_linux_example
Summary:
The documentation exhibits a Windows bias by referencing Windows file paths (e.g., c:\Templates\...), using PowerShell examples and terminology first, and not providing explicit Linux/macOS path or shell examples. Directory creation and file path instructions assume a Windows environment, and there are no explicit Linux/macOS equivalents or notes for cross-platform users.
Recommendations:
- Provide Linux/macOS file path examples (e.g., /home/user/Templates/linkedTS/azuredeploy.json) alongside Windows paths.
- When instructing users to create directories, include both Windows (File Explorer, Command Prompt, PowerShell) and Linux/macOS (mkdir command) instructions.
- Alternate the order of PowerShell and Azure CLI examples, or present CLI examples first to avoid implicit prioritization of Windows tools.
- Add explicit notes or callouts for cross-platform compatibility, clarifying that all commands and templates work on Linux/macOS as well as Windows.
- Where variable assignment or scripting differs between Windows (PowerShell) and Linux/macOS (bash), provide both syntaxes.
- Avoid assuming the user's environment; use neutral language such as "your local computer" and provide both Windows and Linux/macOS context where appropriate.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
Flagged Code Snippets
---
## Deploy template spec
You can now deploy the template spec. Deploying the template spec is just like deploying the template it contains, except that you pass in the resource ID of the template spec. You use the same deployment commands, and if needed, pass in parameter values for the template spec.
# [PowerShell](#tab/azure-powershell)