← Back to Dashboard
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 URL: https://github.com/MicrosoftDocs/azure-docs/tree/main/articles

Current Phase: discovery

Problematic Pages

https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/api-management/api-management-howto-use-managed-service-identity.md [View Details]
High Priority
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.
GitHub Create pull request

No problematic pages found in this scan. All pages appear to be Linux-friendly! 🐧