App Service
432
Total Pages
240
Linux-Friendly Pages
192
Pages with Bias
44.4%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
2121 issues found
Showing 1776-1800 of 2121 flagged pages
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
...service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation assumes a development environment based on .NET and Azure App Service, with all examples and instructions tailored to ASP.NET Core and related Microsoft tooling. It references GitHub Codespaces and Azure CLI, which are cross-platform, but does not provide any explicit Linux-specific instructions, nor does it mention or demonstrate how to perform the same tasks in a Linux-native environment (e.g., using Linux terminal, editors, or deployment patterns). There are no PowerShell-specific commands, but the overall workflow is Windows/Microsoft-centric, and Linux users are left to infer compatibility.
Recommendations
- Explicitly state that all CLI commands (dotnet, azd) work on Linux, macOS, and Windows, and provide any necessary prerequisites for Linux (e.g., installing .NET SDK, Azure CLI).
- Include Linux-specific instructions or notes, such as how to open the app in a browser from a Linux terminal, or how to run and debug the app using common Linux editors (VS Code, Vim, etc.).
- Mention how to deploy from a local Linux environment, not just from Codespaces or GitHub Actions.
- If referencing file paths, use forward slashes or clarify path conventions for both Windows and Linux.
- Add a section or callout confirming that all steps are cross-platform, and link to official .NET and Azure CLI installation guides for Linux.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation provides a troubleshooting step for clearing the DNS cache that only mentions the Windows command (`ipconfig /flushdns`) and does not provide equivalent instructions for Linux or macOS users. No Linux or cross-platform alternatives are mentioned, and the Windows tool is presented as the default solution.
Recommendations
- Include equivalent DNS cache clearing instructions for Linux (e.g., `sudo systemd-resolve --flush-caches` or `sudo service nscd restart`) and macOS (e.g., `sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder`).
- When mentioning platform-specific commands, explicitly state the platform (e.g., 'On Windows, use...; on Linux, use...; on macOS, use...').
- Review the documentation for other potential platform-specific instructions or screenshots and ensure parity for Linux and macOS users.
- Consider adding a short section or a table summarizing common troubleshooting commands for all major platforms.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/includes/tutorial-microsoft-graph-as-app/introduction.md
...cludes/tutorial-microsoft-graph-as-app/introduction.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides both PowerShell and Azure CLI scripts for granting Microsoft Graph permissions, but the PowerShell example is presented first and in greater detail, which may suggest a preference for Windows-centric tooling. There is no explicit Linux example or mention of Linux-specific considerations, and the PowerShell script uses modules and commands more familiar to Windows users.
Recommendations
- Present Azure CLI examples before PowerShell, as Azure CLI is cross-platform and more familiar to Linux users.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide any necessary Linux-specific notes (e.g., shell syntax, environment variables).
- If PowerShell is included, clarify that PowerShell Core is available cross-platform, or provide Bash alternatives where possible.
- Add a short section or note confirming that all steps are supported on Linux and macOS, not just Windows.
- Where screenshots or UI instructions are given, ensure they are not Windows-specific or clarify if the experience is the same across platforms.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/app-service-web-configure-tls-mutual-auth.md
...p-service/app-service-web-configure-tls-mutual-auth.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation demonstrates a moderate Windows bias. While the configuration steps are generally platform-agnostic (using Azure Portal, CLI, Bicep, ARM), the only detailed application code samples for direct certificate access and validation in .NET are for ASP.NET Core and ASP.NET Web Forms—both Windows-centric frameworks. There are no Linux-native web server (e.g., Nginx, Apache) configuration examples, nor are there any command-line examples for Linux (such as using OpenSSL or curl for testing mutual TLS). The documentation assumes the use of the X-ARR-ClientCert header, which is specific to Azure App Service's reverse proxy, but does not discuss how to set up or validate client certificates in a Linux-native environment outside of .NET or Node/Java/Python frameworks.
Recommendations
- Add examples for configuring mutual TLS on Linux-native web servers such as Nginx and Apache, including relevant configuration snippets.
- Include Linux command-line examples for testing mutual TLS endpoints (e.g., using curl with client certificates).
- Provide parity in code samples for popular Linux-first frameworks (e.g., FastAPI for Python, Ktor for Kotlin, Go net/http).
- Clarify that the X-ARR-ClientCert header is Azure-specific and provide guidance for scenarios where apps are hosted on Linux containers or outside Azure App Service.
- Ensure that any references to Windows-specific frameworks or tools are balanced with Linux equivalents, or at least mention alternatives.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/includes/tutorial-cleanup.md
...main/articles/app-service/includes/tutorial-cleanup.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation provides instructions for cleaning up resources using the Azure portal, which is a graphical interface accessible from any OS, but does not offer command-line examples. There are no examples for Linux users (e.g., Azure CLI commands), and the absence of such examples can be seen as a bias towards Windows users, who are more likely to use the portal or PowerShell. The documentation also does not mention or demonstrate Linux-friendly tools or workflows.
Recommendations
- Add Azure CLI command-line examples for deleting the resource group, which work cross-platform (Windows, Linux, macOS).
- Explicitly mention that the Azure portal is OS-agnostic, but provide parity by including both GUI and CLI instructions.
- If PowerShell or Windows-specific tools are mentioned elsewhere, ensure equivalent Bash/Linux instructions are present and given equal prominence.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/includes/tutorial-dotnet-storage-managed-identity/introduction.md
...torial-dotnet-storage-managed-identity/introduction.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for resource creation and role assignment, but consistently lists PowerShell (a Windows-centric tool) before Azure CLI. There are no Linux-specific shell or scripting examples, and the CLI examples use Bash syntax but are not explicitly labeled as Linux-friendly. The portal instructions are platform-agnostic, but the emphasis on PowerShell and its placement before CLI may signal a Windows-first bias.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI examples first, as CLI is cross-platform and more familiar to Linux users.
- Explicitly mention that Azure CLI commands are suitable for Linux, macOS, and Windows, and consider labeling CLI sections as 'Bash/Azure CLI' to clarify Linux compatibility.
- Where possible, include Linux-specific notes or troubleshooting tips, especially for authentication or environment setup.
- Consider adding a short section or callout for Linux users, highlighting that all Azure CLI commands can be run natively on Linux and providing links to Azure CLI installation instructions for Linux.
- If relevant, provide examples using other common Linux tools (e.g., curl, jq) for interacting with Azure REST APIs, or at least acknowledge their use.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-secure-domain-certificate.md
...cles/app-service/tutorial-secure-domain-certificate.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally platform-neutral, focusing on Azure Portal UI steps. However, in the troubleshooting section for clearing DNS cache, only the Windows-specific command (`ipconfig /flushdns`) is mentioned, with no equivalent instructions for Linux or macOS users. This presents a subtle 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing troubleshooting steps involving system commands (such as clearing DNS cache), include equivalent instructions 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`).
- Explicitly mention that the instructions apply to all major operating systems, or provide links to platform-specific guidance.
- Review other troubleshooting or command-line examples to ensure parity across Windows, Linux, and macOS.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
...service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation assumes a development environment that is compatible with .NET and Azure App Service, but it does not provide explicit Linux or cross-platform instructions or examples. The workflow references GitHub Codespaces (which is cross-platform) and Azure CLI, but there are no examples or notes for Linux-specific environments, terminal commands, or deployment nuances. There is also an implicit Windows-first bias by focusing on ASP.NET Core and Azure App Service without mentioning Linux hosting or alternative deployment scenarios.
Recommendations
- Include explicit notes that all .NET Core and Azure CLI commands work on Linux, macOS, and Windows, and clarify any OS-specific prerequisites.
- Add examples or instructions for running and testing the app locally on Linux (e.g., using bash, Linux file paths, or Linux package managers for .NET SDK installation).
- Mention that Azure App Service supports both Windows and Linux hosting plans, and provide guidance for deploying to Linux-based App Service if relevant.
- If referencing 'Open in Browser' or other UI actions, clarify how these steps are performed in Linux desktop environments or via command line.
- Ensure that all terminal commands are shown in a cross-platform way (e.g., avoid Windows-specific CLI syntax or assumptions about the shell).
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page is generally platform-neutral but contains a subtle Windows bias in the troubleshooting section, where only the Windows-specific command ('ipconfig /flushdns') is provided for clearing the DNS cache. No equivalent instructions or commands are given for Linux or macOS users. There are no PowerShell-heavy sections or exclusive references to Windows tools, but the omission of Linux/macOS examples in this context may hinder parity.
Recommendations
- When mentioning platform-specific commands (such as clearing DNS cache), provide equivalent instructions 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').
- Explicitly state that the instructions apply to all platforms, and include notes or callouts for any platform-specific differences.
- Review other troubleshooting or automation sections to ensure Linux/macOS users are not overlooked when platform-specific actions are described.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-secure-domain-certificate.md
...cles/app-service/tutorial-secure-domain-certificate.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally platform-neutral but contains a subtle Windows bias in the troubleshooting section. Specifically, when instructing users how to clear the DNS cache, only the Windows-specific command (`ipconfig /flushdns`) is provided, with no mention of equivalent commands for Linux or macOS. No PowerShell-specific commands or Windows-only tools are otherwise present, but the lack of Linux/macOS parity in this example can disadvantage non-Windows users.
Recommendations
- Include equivalent DNS cache flush instructions for Linux (e.g., `sudo systemd-resolve --flush-caches` or `sudo service nscd restart`) and macOS (e.g., `sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder`).
- When giving OS-specific troubleshooting steps, present all major platforms together or link to platform-specific instructions.
- Review other troubleshooting or command-line sections to ensure parity for Linux and macOS users.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
...service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation assumes a development workflow centered on .NET and Azure App Service, with all examples and instructions tailored to ASP.NET Core and related Microsoft tooling. There are no Linux-specific instructions, nor are there examples for deploying or running the sample app outside of the Azure/Microsoft ecosystem. The use of GitHub Codespaces and Azure CLI is cross-platform, but the lack of explicit Linux (or macOS) terminal commands, package installation steps, or alternative frameworks (such as for Node.js, Python, or Java) suggests a bias toward Windows/Microsoft environments.
Recommendations
- Add explicit notes that the tutorial works on Linux and macOS as well as Windows, especially since .NET Core is cross-platform.
- Include Linux/macOS-specific terminal commands where appropriate (e.g., for running the app, installing .NET SDK, or using the Azure CLI).
- Mention alternative editors or IDEs (such as VS Code on Linux/macOS) alongside Codespaces.
- Provide a brief section or appendix on deploying and running the sample app on a local Linux machine or on a Linux-based cloud VM.
- Clarify that Azure App Service supports both Windows and Linux hosting, and provide links or instructions for both.
- Where security best practices are discussed, mention Linux-specific considerations (such as file permissions, firewall configuration, etc.) if relevant.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page is generally cross-platform and avoids explicit Windows or PowerShell bias in its main instructions. However, in the troubleshooting section under 'Test the DNS resolution', only the Windows-specific command ('ipconfig /flushdns') is provided for clearing the DNS cache, with no mention of Linux or macOS equivalents. This subtly prioritizes Windows users and omits guidance for those on other platforms.
Recommendations
- When providing OS-specific commands (such as clearing DNS cache), include equivalent instructions for Linux (e.g., 'sudo systemd-resolve --flush-caches' or 'sudo service nscd restart') and macOS (e.g., 'sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder').
- Wherever possible, avoid referencing only Windows tools or commands in troubleshooting or automation sections.
- Consider adding a short note or table listing common DNS cache flush commands for Windows, Linux, and macOS to ensure parity.
- Review other sections for subtle platform assumptions and ensure all users are equally supported.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-secure-domain-certificate.md
...cles/app-service/tutorial-secure-domain-certificate.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally platform-neutral, focusing on Azure Portal UI steps. However, in the troubleshooting section, the only example for clearing DNS cache is for Windows (`ipconfig /flushdns`), with no mention of Linux or macOS equivalents. This presents a subtle 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing command-line troubleshooting steps (such as clearing DNS cache), 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`).
- If referencing OS-specific tools or commands, present them in parallel (Windows, Linux, macOS) or link to official documentation for each platform.
- Review other troubleshooting or advanced sections to ensure parity in examples and instructions for all major operating systems.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
...service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation assumes a development environment using GitHub Codespaces and .NET, but does not provide explicit Linux or cross-platform command-line examples. It references the Azure Developer CLI (azd) and dotnet CLI, which are cross-platform, but omits any mention of Linux-specific workflows, shell commands, or deployment patterns. There are no Windows-specific tools or PowerShell commands, but the lack of Linux/Unix shell examples and the assumption of a browser-based or Visual Studio Code workflow may disadvantage Linux users.
Recommendations
- Explicitly mention that all CLI commands (dotnet, azd) work on Linux, macOS, and Windows.
- Provide example shell commands for Linux/macOS users (e.g., using bash instead of assuming a codespace terminal).
- Clarify that the tutorial does not require Windows or Visual Studio, and can be completed entirely on Linux or macOS.
- Include notes or callouts for Linux users regarding file paths, environment variables, and browser access.
- If referencing GitHub Codespaces, mention that it is a Linux-based environment and suitable for all platforms.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation contains a subtle Windows bias in the troubleshooting section, where only the Windows-specific command ('ipconfig /flushdns') is provided for clearing the DNS cache. No equivalent Linux or macOS commands are mentioned, and Windows is the only OS explicitly referenced in this context. The rest of the documentation is platform-neutral, focusing on Azure Portal UI and DNS provider interfaces.
Recommendations
- Provide equivalent DNS cache flush commands for Linux (e.g., 'sudo systemd-resolve --flush-caches' or 'sudo service nscd restart') and macOS (e.g., 'sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder').
- Rephrase troubleshooting steps to address users on all major platforms, not just Windows.
- Where OS-specific instructions are needed, present them in a tabbed or bulleted format, giving parity to Windows, Linux, and macOS.
- Review future documentation for similar single-platform troubleshooting tips and ensure cross-platform inclusivity.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-secure-domain-certificate.md
...cles/app-service/tutorial-secure-domain-certificate.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally platform-neutral, focusing on Azure Portal UI steps. However, in the troubleshooting section for clearing DNS cache, only the Windows-specific command (`ipconfig /flushdns`) is provided, with no mention of Linux or macOS equivalents. This presents a subtle 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing troubleshooting steps involving command-line tools, 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`).
- If referencing OS-specific tools or commands, present them in a cross-platform table or list, or at least mention that steps may differ on non-Windows systems.
- Consider adding a note or section for non-Windows users, especially in troubleshooting, to ensure parity and inclusivity.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
...service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation assumes the use of GitHub Codespaces and Azure App Service, which are cross-platform, but all examples and instructions are focused on .NET and do not mention Linux-specific workflows or tools. There are no explicit Windows-only tools (like PowerShell), but the lack of Linux terminal commands, package managers, or deployment instructions (e.g., for self-hosted Linux environments) indicates a bias toward Windows-centric or abstracted (cloud) environments. There are no examples for running or deploying the app on a local Linux machine, nor any mention of Linux-specific considerations.
Recommendations
- Include instructions for running and deploying the sample app on a local Linux machine (e.g., Ubuntu), including installation of .NET SDK and required dependencies.
- Provide Linux shell (bash) equivalents for any terminal commands, especially for package installation and running the app.
- Mention how to use editors and tools commonly available on Linux (e.g., VS Code on Linux, nano/vim for editing files).
- Add a note clarifying that the tutorial works on both Windows and Linux, and highlight any OS-specific steps if applicable.
- If using Azure CLI or GitHub Codespaces, clarify that these are cross-platform and provide links to Linux setup guides where relevant.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page is generally platform-neutral, focusing on Azure Portal and DNS provider interfaces. However, in the troubleshooting section for clearing DNS cache, only the Windows-specific command ('ipconfig /flushdns') is mentioned, with no equivalent commands for Linux or macOS. This presents a subtle 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing troubleshooting steps such as clearing DNS cache, 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').
- Wherever OS-specific instructions are given, present them in a cross-platform format (e.g., using tabs or bullet points for Windows, Linux, and macOS).
- Review other sections for any implicit platform assumptions and ensure parity in examples and troubleshooting guidance.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
...service/tutorial-ai-integrate-azure-ai-agent-dotnet.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation assumes a development environment that is compatible with .NET and Azure App Service, and it references GitHub Codespaces and Azure CLI for deployment. However, it does not provide any Linux-specific instructions, terminal commands, or examples, nor does it mention Linux tooling or patterns. The workflow and examples are generic enough to work cross-platform, but the absence of explicit Linux or non-Windows guidance, especially for local development, may disadvantage Linux users.
Recommendations
- Explicitly mention that all commands and steps work on Linux, macOS, and Windows, or call out any differences.
- Provide example terminal commands for both Windows (PowerShell/CMD) and Linux/macOS (bash/zsh) where applicable.
- Include a note about installing .NET SDK and Azure CLI on Linux, with links to official installation guides.
- If using Codespaces, clarify that it provides a Linux-based environment, and offer alternative steps for users developing locally on Linux.
- Add troubleshooting tips for common Linux-specific issues (e.g., file permissions, environment variables).
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/tutorial-secure-domain-certificate.md
...cles/app-service/tutorial-secure-domain-certificate.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally platform-neutral, focusing on Azure Portal UI steps. However, in the troubleshooting section for clearing DNS cache, only the Windows-specific command (`ipconfig /flushdns`) is mentioned, with no equivalent instructions for Linux or macOS users. This constitutes a 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing troubleshooting steps such as clearing DNS cache, 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`).
- Explicitly mention that the instructions apply to all platforms, or provide platform-specific notes where relevant.
- Review other troubleshooting or command-line instructions to ensure parity across Windows, Linux, and macOS.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page is generally cross-platform and avoids explicit Windows or PowerShell bias in its main instructions. However, in the troubleshooting section, when suggesting how to clear the DNS cache, only the Windows-specific command ('ipconfig /flushdns') is mentioned, with no equivalent Linux or macOS instructions. This is an example of 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing troubleshooting steps that involve OS-specific commands (such as clearing the DNS cache), include equivalent instructions for Linux (e.g., 'sudo systemd-resolve --flush-caches' or 'sudo /etc/init.d/nscd restart') and macOS (e.g., 'sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder').
- Wherever possible, avoid assuming the user is on Windows. If a command is OS-specific, present alternatives for all major platforms, or link to platform-specific instructions.
- Consider adding a short note or a tabbed section for clearing DNS cache on Windows, Linux, and macOS to ensure parity and inclusivity.
App Service
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/app-service/app-service-web-configure-tls-mutual-auth.md
...p-service/app-service-web-configure-tls-mutual-auth.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a moderate Windows bias, primarily by presenting .NET/ASP.NET (Windows-centric) code samples first and in greater detail, while not providing any explicit Linux shell (bash) or OpenSSL command-line examples for certificate handling or validation. The focus is on Azure portal, Azure CLI, Bicep, and ARM templates for configuration, which are cross-platform, but the application code samples are heavily weighted toward Windows technologies. There are no examples of using Linux-native tools or patterns for mutual TLS setup or troubleshooting.
Recommendations
- Add Linux shell (bash) and OpenSSL command-line examples for generating, inspecting, and validating client certificates, as these are common on Linux systems.
- Include explicit instructions or examples for configuring mutual TLS in popular Linux web servers (e.g., Nginx, Apache) when running on Azure App Service for Linux.
- Balance the order of code samples by presenting cross-platform or Linux-first examples (such as Node.js, Python, or Java) before or alongside Windows/.NET examples.
- Mention Linux-native troubleshooting tools (e.g., curl, openssl s_client) for verifying mutual TLS connections.
- Clarify that the provided code samples are applicable to both Windows and Linux App Service plans, or note any platform-specific differences.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page is largely platform-neutral, focusing on Azure Portal and DNS provider interfaces. However, in the troubleshooting section, the only example for clearing the DNS cache is for Windows (`ipconfig /flushdns`), with no mention of the equivalent commands for Linux or macOS. This presents a subtle 'windows_first' and 'missing_linux_example' bias.
Recommendations
- When providing troubleshooting steps such as clearing the DNS cache, 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`).
- Explicitly state that the instructions apply to all platforms, and provide parity in examples where OS-specific actions are mentioned.
- If automation or scripting is referenced, ensure examples are provided for both PowerShell (Windows) and Bash (Linux/macOS) where relevant.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation provides a troubleshooting step for clearing the DNS cache that only references the Windows-specific command 'ipconfig /flushdns', without mentioning the equivalent commands for Linux or macOS. No PowerShell or Windows tool bias is present elsewhere, but this omission results in a subtle Windows-first and missing Linux example bias.
Recommendations
- When suggesting DNS cache clearing, include equivalent commands for Linux (e.g., 'sudo systemd-resolve --flush-caches' or 'sudo service nscd restart') and macOS (e.g., 'sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder').
- Wherever platform-specific troubleshooting is mentioned, provide parity for Linux and macOS users, or link to official documentation for those platforms.
- Consider a short note or table listing common DNS cache flush commands for all major platforms to ensure inclusivity.
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 →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page generally avoids OS-specific instructions, but in the troubleshooting section, it provides a Windows-specific command ('ipconfig /flushdns') for clearing the DNS cache without mentioning the equivalent for Linux or macOS. No Linux or cross-platform alternatives are provided, and Windows is implicitly prioritized.
Recommendations
- Provide equivalent DNS cache clearing instructions for Linux (e.g., 'sudo systemd-resolve --flush-caches' or 'sudo service nscd restart') and macOS (e.g., 'sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder').
- When giving OS-specific commands, present them in a cross-platform table or list, or explicitly mention alternatives for Linux and macOS.
- Review other troubleshooting and automation sections to ensure parity and inclusion of Linux/macOS where relevant.
- Consider adding a note that the instructions apply to all major platforms, and clarify any platform-specific steps.