Programmable Connectivity

10
Total Pages
9
Linux-Friendly Pages
1
Pages with Bias
10.0%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues (2)

https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/programmable-connectivity/azure-programmable-connectivity-using-network-apis.md [View Details]
Scanned: 2025-07-13 21:37 • Page-level bias detected
▼

Page-Level Analysis

Windows First Powershell Heavy Windows Tools Missing Linux Example
Summary:
The documentation demonstrates a Windows bias by listing PowerShell and Azure portal instructions before or alongside Azure CLI, with no explicit Linux or cross-platform command-line examples. The SDK example is .NET-focused, which is more common on Windows. There are no Linux-specific instructions or examples, and the documentation does not mention or show parity for Linux/macOS environments.
Recommendations:
  • Provide explicit Linux/macOS command-line examples, especially for authentication steps (e.g., using Azure CLI on Bash).
  • List Azure CLI instructions before PowerShell, or present them side-by-side, clarifying cross-platform compatibility.
  • Include SDK usage examples for other popular cross-platform languages (such as Python or JavaScript), not just .NET.
  • Mention that Azure CLI is available on all major platforms and highlight any differences in usage between Windows and Linux/macOS.
  • Where portal instructions are given, clarify that the Azure portal is web-based and platform-independent.
  • Review all examples to ensure that none assume a Windows environment by default.
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/programmable-connectivity/azure-programmable-connectivity-using-network-apis.md [View Details]
Scanned: 2025-07-12 23:44 • Page-level bias detected
▼

Page-Level Analysis

Windows First Powershell Heavy Missing Linux Example
Summary:
The documentation demonstrates a Windows bias in several areas: when describing how to obtain an authentication token, it lists Azure CLI and PowerShell, but the PowerShell example is specifically called out, and there is no explicit mention of Linux or bash/zsh shell equivalents. The SDK example is .NET-focused, which is more common on Windows. There are no Linux-specific command-line examples or references to Linux-native tools. The documentation assumes familiarity with Windows-centric tools and patterns, and does not provide parity for Linux users.
Recommendations:
  • Provide explicit bash/zsh/Linux shell examples for obtaining tokens (e.g., using curl, jq, or az CLI in bash).
  • List Azure CLI (which is cross-platform) before PowerShell, and clarify that CLI commands work on Linux/macOS as well as Windows.
  • Include code snippets or instructions for Linux users wherever PowerShell or Windows-specific tools are mentioned.
  • Offer SDK usage examples in other languages common on Linux (e.g., Python, Java, Node.js), or at least reference their documentation.
  • Explicitly state that the APIs and tools are cross-platform where applicable, and provide guidance for both Windows and Linux environments.