← Back to Dashboard
1063
Pages Scanned
2
Pages Flagged
1063
Changed Pages
0.2%
% Pages Flagged

Scan Information

Started At: 2025-07-24 00:00:07

Finished At: 2025-07-24 00:04:08

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 (which is cross-platform and more commonly used on Linux/macOS). The PowerShell approach is presented as the default scripting method, and there are no Bash or Linux-native instructions. The documentation also references installation of Azure PowerShell, a tool most closely associated with Windows environments, and does not provide parity for Linux users.
Recommendations:
  • Add equivalent Azure CLI (az) command examples alongside all PowerShell examples, as Azure CLI is cross-platform and widely used on Linux and macOS.
  • In sections where PowerShell is referenced, explicitly mention that Azure CLI can be used as an alternative, and provide links to relevant Azure CLI documentation.
  • Ensure that installation instructions for Azure CLI are included, or at least referenced, for users on Linux and macOS.
  • Where scripting examples are given, consider providing both PowerShell and Bash/Azure CLI versions, or use tabs to allow users to select their preferred environment.
  • Avoid presenting PowerShell as the only or primary automation tool; instead, introduce both PowerShell and CLI approaches together.
  • Review all references to Windows-specific tools or patterns and ensure Linux equivalents are mentioned with equal prominence.
GitHub Create pull request
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/app-service-web-tutorial-custom-domain.md [View Details]
Medium Priority
Bias Types:
⚠️ windows_first
⚠️ missing_linux_example
Summary:
The documentation page is generally platform-neutral, focusing on Azure portal steps and DNS concepts. However, in the troubleshooting section, only a Windows-specific command ('ipconfig /flushdns') is provided for clearing the DNS cache, with no mention of equivalent commands for Linux or macOS. This presents a subtle 'windows_first' and 'missing_linux_example' bias.
Recommendations:
  • When providing troubleshooting steps, include equivalent commands for Linux (e.g., 'sudo systemd-resolve --flush-caches' or 'sudo resolvectl flush-caches') and macOS (e.g., 'sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder') alongside the Windows 'ipconfig /flushdns' command.
  • Wherever OS-specific instructions are necessary, present them in a cross-platform format (e.g., using tabs or lists for Windows, Linux, and macOS).
  • Review other sections for any subtle platform assumptions and ensure parity in examples and instructions.
GitHub Create pull request

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