29
Total Pages
17
Linux-Friendly Pages
12
Pages with Bias
41.4%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

29 issues found
Showing 26-29 of 29 flagged pages
Managed Ccf https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/managed-ccf/how-to-update-application.md ...main/articles/managed-ccf/how-to-update-application.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Missing Linux Example Macos First
Summary
The documentation provides explicit instructions for macOS but does not mention or provide examples for Linux or Windows. There is a notable absence of Linux-specific guidance, which may hinder Linux users. No Windows or PowerShell-specific tools or patterns are present, nor is there a 'Windows-first' ordering, but the omission of Linux examples is a bias.
Recommendations
  • Add a dedicated section or include instructions for Linux users, ensuring parity with the macOS instructions.
  • If the steps are identical for Linux and macOS, clarify this explicitly to reassure Linux users.
  • Consider providing Windows instructions if relevant, or state clearly if the process is not supported or differs on Windows.
Managed Ccf https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/managed-ccf/get-started.md ...ure-docs/blob/main/articles/managed-ccf/get-started.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation shows mild Windows bias by using the 'del-cli' tool in the npm build script, which is a Windows-centric utility for deleting files/folders. While the rest of the instructions and shell commands are Unix-like (bash), the inclusion of 'del-cli' and the lack of explicit Linux/macOS alternatives or notes may cause confusion or friction for non-Windows users. However, the majority of the examples use bash syntax and Linux-style paths, and there are no PowerShell examples or exclusive references to Windows-only tools beyond 'del-cli'.
Recommendations
  • Replace 'del-cli' with a cross-platform alternative such as 'rimraf' in the npm build script, or provide separate instructions/scripts for Windows and Linux/macOS environments.
  • Explicitly mention that the build instructions and shell commands are intended for Unix-like systems, and provide Windows (cmd/PowerShell) equivalents where appropriate.
  • Audit all CLI tool usage in scripts for cross-platform compatibility and document any OS-specific requirements or alternatives.
  • Add a note in the prerequisites or build section clarifying any differences in commands or tools between Windows and Linux/macOS.
Managed Ccf https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/managed-ccf/quickstart-cli.md ...-docs/blob/main/articles/managed-ccf/quickstart-cli.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation shows subtle Windows bias: file paths in the Azure CLI example use Windows-style (c:/certs/...), and there are no Linux path examples or notes for Linux users. While OpenSSL is mentioned as required for both Windows and Linux, the CLI usage examples only reflect Windows conventions.
Recommendations
  • Provide both Windows and Linux file path examples in CLI commands (e.g., 'c:/certs/member0_cert.pem' and '/home/user/certs/member0_cert.pem').
  • Add a note clarifying that file paths should be adapted for the user's OS.
  • Explicitly mention that all CLI commands work on both Windows and Linux, and provide OS-agnostic or dual examples where file paths are shown.
Managed Ccf https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/managed-ccf/quickstart-deploy-application.md .../articles/managed-ccf/quickstart-deploy-application.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Missing Linux Example Windows First
Summary
The documentation mentions both Windows and Linux in the prerequisites for OpenSSL, but does not provide any explicit Linux-specific instructions or examples in the visible content. There is a section for Mac instructions, but no equivalent for Linux. The ordering of 'Windows or Linux' in the prerequisites may also subtly prioritize Windows.
Recommendations
  • Add explicit Linux instructions or examples alongside the Mac instructions, especially for command-line operations or environment setup.
  • Ensure that any included snippets or referenced files (such as 'service-identity.md' or 'deploy-update-application.md') contain Linux-specific guidance if they contain platform-specific steps.
  • Consider reordering mentions to 'Linux or Windows' or simply 'Windows, Linux, or Mac' to avoid subtle prioritization.
  • If there are any scripts or commands, provide both Windows (PowerShell/CMD) and Linux (bash) variants.
← Previous Page 2 of 2 Next →