1359
Pages Scanned
1
Pages Flagged
1359
Changed Pages
0.1%
% Pages Flagged
Scan Information
Started At: 2025-07-31 00:00:07
Finished At: 2025-07-31 00:06:01
Status: completed
Target Repo: Azure
Current Phase: discovery
Files Queued: 1359
Files Completed: 1359
Problematic Pages
1 issue found
API Management
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/api-management/api-management-howto-use-managed-service-identity.md
...t/api-management-howto-use-managed-service-identity.md
High Priority
View Details →
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a Windows bias by providing only Azure PowerShell command-line examples for scripting and automation, with no mention of Azure CLI (cross-platform) or Bash/shell equivalents. PowerShell is a Windows-centric tool, and its exclusive use may disadvantage Linux/macOS users. Additionally, the documentation refers to installing Azure PowerShell and links to PowerShell-specific resources, without offering Linux-native or cross-platform alternatives. The ordering of examples also places PowerShell before ARM templates, and there are no Linux-specific instructions or notes.
Recommendations
- Add equivalent Azure CLI (az) command examples alongside PowerShell for all scripting/automation tasks, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Include Bash/shell script snippets where appropriate, or at least reference that Azure CLI commands can be run in Bash.
- When listing command-line options, present Azure CLI first or in parallel with PowerShell to avoid a 'Windows-first' impression.
- Explicitly mention that all features are available and supported on Linux/macOS, and provide links to relevant cross-platform tooling documentation.
- Consider adding a table or section comparing PowerShell and Azure CLI approaches for common tasks.
- Where screenshots or UI instructions are given, clarify that the Azure Portal is accessible from any OS.
Create Pull Request