← 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 Repo: Azure

Current Phase: discovery

Files Queued: 1063

Files Completed: 1063

Problematic Pages

2 issues 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 →
Reviewed by: Unknown
Issues: 4 bias types
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 (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
App Service https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/app-service-web-tutorial-custom-domain.md .../app-service/app-service-web-tutorial-custom-domain.md
Medium Priority View Details →
Reviewed by: Unknown
Issues: 2 bias types
Detected 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