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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation page demonstrates a moderate Windows bias. PowerShell is presented first and in more detail when describing how to set deployment mode, with a full PowerShell example using a Windows-style file path (c:\MyTemplates\storage.json). The Azure CLI example follows, but uses a generic filename without a path, missing an explicit Linux-style example. The documentation references PowerShell in the 'Next steps' section and links to a PowerShell-specific deployment guide, with no equivalent emphasis on Bash or Linux shell environments. There are no explicit Linux or cross-platform shell examples, and Windows conventions (such as file paths and PowerShell syntax) are foregrounded.
Recommendations:
- Provide both Windows (PowerShell) and Linux/macOS (Bash) examples side by side when demonstrating CLI usage, including file paths appropriate for each OS.
- Avoid using Windows-specific file paths (e.g., c:\MyTemplates\storage.json) in generic examples; instead, use cross-platform or dual examples (e.g., c:\MyTemplates\storage.json and ~/MyTemplates/storage.json).
- In 'Next steps', include links to both PowerShell and Bash/Azure CLI deployment guides to ensure parity.
- When referencing tools or commands, clarify cross-platform compatibility and note any OS-specific considerations.
- Consider adding a short section or note explicitly stating that all examples work on both Windows and Linux/macOS, and provide guidance for users on each platform.
Create pull request