29
Total Pages
27
Linux-Friendly Pages
2
Pages with Bias
6.9%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues (3)

Page-Level Analysis

Windows First Powershell Heavy
Summary:
The documentation provides both Bash and PowerShell examples for generating an access token, but the PowerShell example is more detailed and appears after the Bash example, which is a positive sign. However, throughout the document, all instructions for portal-based actions (such as app registration, role assignment, and resource creation) are described in a way that assumes use of the Azure Portal GUI, which is more familiar to Windows users. There are no CLI-based (e.g., Azure CLI) instructions for Linux users for these steps. The only command-line examples are for token generation, and while Bash is included, there is a heavier focus on PowerShell with more detailed scripting. There are no references to Linux-specific tools or patterns, and no mention of how to perform the same tasks using the Azure CLI or other cross-platform tools.
Recommendations:
  • Add Azure CLI examples for all steps that can be performed via CLI, such as resource provider registration, app registration, role assignment, and token generation.
  • Ensure that for every PowerShell example, there is a corresponding Bash/Azure CLI example with equal detail and explanation.
  • Include explicit instructions or links for Linux/macOS users, especially for steps that are currently only described using the Azure Portal GUI.
  • Avoid assuming the use of the Azure Portal for all actions; provide parity for users who prefer or require command-line tools.
  • Where screenshots are used, consider including CLI output examples or terminal screenshots to balance the visual focus.

Page-Level Analysis

Windows First Powershell Heavy
Summary:
The documentation provides both Bash and PowerShell examples for generating an access token, but the PowerShell example is more detailed and comes after the Bash example. Throughout the document, all portal-based instructions and screenshots are platform-agnostic, but there is a subtle Windows bias in the inclusion and detail of the PowerShell example. There are no Linux-specific tools or CLI-based alternatives for steps that could be performed outside the portal, and the PowerShell example may implicitly prioritize Windows users.
Recommendations:
  • Ensure that Bash and PowerShell examples are equally detailed and placed in parallel, not with one prioritized over the other.
  • Consider adding Azure CLI examples for steps like app registration, role assignment, and resource creation, which would benefit Linux and cross-platform users.
  • Explicitly mention that all steps can be performed on any OS using the Azure CLI or REST APIs, not just via the Azure Portal or PowerShell.
  • Where possible, provide Linux-specific troubleshooting tips or notes, especially for authentication and token generation.
  • Review screenshots and instructions to ensure they do not assume a Windows environment (e.g., avoid referencing Windows-specific UI elements or terminology).

Page-Level Analysis

Windows Tools Missing Linux Example
Summary:
The documentation provides a command example using the ARMClient tool, which is a Windows-centric utility, and does not mention or provide equivalent instructions for Linux or cross-platform alternatives. There are no Linux shell or CLI examples, nor is there guidance for users on non-Windows systems.
Recommendations:
  • Provide equivalent instructions using Azure CLI (az), which is cross-platform and commonly used on Linux and macOS.
  • Explicitly mention whether ARMClient is available for Linux/macOS, and if not, suggest alternatives.
  • Add bash or shell command examples alongside PowerShell/Windows-specific ones.
  • Clarify any OS-specific requirements or differences in the installation and usage of required tools.