Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page for managing Azure Reservations demonstrates a notable Windows bias. The only command-line examples for splitting reservations are given using PowerShell, with no equivalent Azure CLI or REST API examples shown. PowerShell is a Windows-centric tool, and its exclusive use in examples creates friction for Linux and macOS users. Additionally, the documentation refers to PowerShell first and does not mention Linux/macOS-specific guidance or parity in command-line tooling.
Recommendations
- Add Azure CLI examples for all PowerShell commands, especially for splitting reservations and updating scopes.
- Include REST API sample requests for reservation management tasks where applicable.
- Explicitly state that Azure CLI and REST API are cross-platform and provide links to their documentation.
- Where screenshots or UI instructions are given, clarify that the Azure portal is web-based and platform-agnostic.
- Ensure that all command-line instructions are available for both Windows and Linux/macOS users.
Create Pull Request