Document Details
Guidance Best Practices
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
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. While it covers Azure Backup concepts broadly and mentions automation channels like PowerShell, CLI, ARM templates, and REST APIs, there is a notable tendency to reference PowerShell procedures and Windows-centric tools first (or exclusively) in automation and troubleshooting sections. Examples and guidance for Linux/macOS users (such as Bash, Azure CLI, or cross-platform scripting) are missing or not prioritized. The use of PowerShell is highlighted for auto-retry scenarios, and there are no explicit Linux or macOS command examples or references to their tooling. This could create friction for non-Windows users, especially in automation and scripting contexts.
Recommendations
- Add explicit Azure CLI and Bash examples alongside PowerShell for automation tasks, especially in sections discussing auto-retry and scripting.
- Ensure that references to automation channels (PowerShell, CLI, ARM, REST) provide parity in example coverage and ordering (e.g., CLI before or alongside PowerShell).
- Include notes or links for Linux/macOS users on how to perform equivalent tasks using their preferred tools.
- When referencing videos or external guides, clarify if the procedures are cross-platform or provide alternative instructions for Linux/macOS.
- Review all sections mentioning scripting or automation to ensure Linux/macOS users are not left without guidance.
Create Pull Request
Clean