Bias Analysis
Detected Bias Types
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for stopping and starting AKS clusters. However, PowerShell examples are presented alongside CLI examples, and the 'Before you begin' section lists Azure CLI, Azure PowerShell, and Azure Portal as options for cluster creation, with PowerShell mentioned before Portal. There are no Linux-specific examples or explicit mention of Linux/macOS compatibility for Azure CLI commands, but Azure CLI is inherently cross-platform. No Windows-only tools or patterns are used, and all critical operations can be completed with Azure CLI, which works on Linux/macOS.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows.
- Consider listing Azure CLI examples first in all sections, as it is the most cross-platform tool.
- Add a note clarifying that Azure PowerShell is primarily for Windows users, while Azure CLI is recommended for Linux/macOS.
- Ensure parity in example output formats (e.g., JSON for CLI, PowerShell output for PowerShell) and clarify differences.
Create Pull Request