Detected Bias Types
🔧
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation references Azure PowerShell as a supported tool for backup and restore operations, and lists it before Linux-native alternatives (e.g., Azure CLI, ARM, Bicep, Terraform) in the 'Next steps' section. However, the main body of the documentation does not provide OS-specific command examples, nor does it show a preference for Windows-only patterns in the core instructions. There is also a clear statement that the Backup Extension cannot be installed on Windows-based node pools, requiring Linux-based node pools for AKS backup, which is a technical limitation rather than a documentation bias.
Recommendations
- In the 'Next steps' section, list cross-platform tools (Azure CLI, Terraform) before Windows-specific tools (Azure PowerShell) to avoid implicit prioritization.
- Explicitly state that Azure CLI and Terraform are cross-platform and provide parity for Linux/macOS users.
- If command examples are provided in linked articles, ensure that Linux/macOS shell examples (bash/zsh) are included alongside PowerShell examples.
- Clarify any OS-specific requirements for management tools (e.g., PowerShell only on Windows) in relevant sections.
- Add a note that Azure PowerShell is primarily for Windows, and recommend Azure CLI for Linux/macOS users.