30
Total Pages
28
Linux-Friendly Pages
2
Pages with Bias
6.7%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

4 issues found
Showing 1-4 of 4 flagged pages
Sre Agent Role based access control to SRE Agent Preview ...docs/blob/main/articles/sre-agent/user-access-roles.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Missing Linux Example
Summary
The documentation page demonstrates a bias towards Windows and Azure Portal tools, with all examples and instructions referencing the Azure portal and Bicep templates for agent deployment and role assignment. There are no references to Linux command-line tools, Azure CLI, or cross-platform automation methods. The workflow and instructions assume use of GUI tools typical of Windows environments, and do not provide parity for Linux/macOS users who may prefer CLI or automation.
Recommendations
  • Add step-by-step instructions for deploying and managing SRE Agent using Azure CLI and/or PowerShell, making clear which commands work cross-platform.
  • Include examples of role assignment using Azure CLI (az role assignment), which is available on Linux/macOS as well as Windows.
  • Reference automation options (e.g., Terraform, ARM templates) that are platform-agnostic.
  • Clarify that all operations can be performed from Linux/macOS using CLI tools, and provide links to relevant documentation.
  • Reorder examples so that CLI and automation options appear before or alongside GUI instructions.
Sre Agent https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/sre-agent/troubleshoot-azure-app-service.md ...n/articles/sre-agent/troubleshoot-azure-app-service.md
Medium Priority View Details →
Scanned: 2025-07-19 13:51
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a Windows bias by specifying 'Windows' as the operating system in the app creation step and omitting any mention of Linux or cross-platform alternatives. There are no examples or instructions for deploying or configuring the app on Linux-based App Service plans, and no Linux-specific guidance is provided for runtime stack, startup commands, or environment variable management.
Recommendations
  • Provide parallel instructions for creating the App Service app on Linux, including selecting 'Linux' as the operating system and specifying supported runtime stacks.
  • Include Linux-specific notes for configuring environment variables and startup commands, as the UI and options can differ from Windows.
  • Add a table or section comparing Windows and Linux App Service plans, highlighting any differences relevant to SRE Agent usage.
  • Ensure that all steps (deployment, slot management, environment variable configuration) are described for both Windows and Linux App Service environments.
  • If certain features are Windows-only, explicitly state this and provide workarounds or alternatives for Linux users.
Sre Agent https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/sre-agent/troubleshoot-azure-app-service.md ...n/articles/sre-agent/troubleshoot-azure-app-service.md
Medium Priority View Details →
Scanned: 2025-07-16 00:00
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a Windows bias by specifying 'Windows' as the operating system in the App Service creation step, without mentioning Linux as an option or providing equivalent instructions/examples for Linux-based App Service apps. There are no Linux-specific notes, nor are there alternative steps or clarifications for users deploying on Linux. All examples and configuration steps implicitly assume a Windows environment.
Recommendations
  • Explicitly mention that App Service supports both Windows and Linux, and provide guidance for both.
  • In the 'Configure the Basics tab' section, include a table row for 'Operating System' that lists both 'Windows' and 'Linux' as valid options, with notes on any differences.
  • If there are any differences in deployment, environment variable configuration, or logging between Windows and Linux App Service, provide parallel instructions or callouts.
  • Add a note clarifying that the sample app and SRE Agent work on both Windows and Linux App Service plans, or specify any limitations.
  • Where screenshots or UI steps differ between Windows and Linux, provide both or clarify the differences.
Sre Agent https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/sre-agent/troubleshoot-azure-app-service.md ...n/articles/sre-agent/troubleshoot-azure-app-service.md
Medium Priority View Details →
Scanned: 2025-07-12 23:44
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a Windows bias by specifying 'Windows' as the operating system in the App Service creation step and not mentioning Linux as an alternative. There are no examples or instructions for deploying or configuring the app on Linux App Service plans, nor are there any Linux-specific notes or parity checks. All runtime and deployment steps assume a Windows environment, and no Linux shell or configuration examples are provided.
Recommendations
  • Explicitly mention that both Windows and Linux App Service plans are supported, if applicable.
  • Provide parallel instructions for creating the App Service on Linux, including screenshots and configuration differences.
  • Include Linux-specific notes for environment variables, deployment, and troubleshooting if there are any differences.
  • When listing the 'Runtime stack' and 'Operating System' options, show both Windows and Linux choices, and clarify any limitations.
  • If certain features are Windows-only, clearly state this early in the documentation and provide workarounds or alternatives for Linux users.