Template Specs Create Linked - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected 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	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-12 00:00	#243	cancelled	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-08-17 00:01	#83	cancelled	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)