About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a clear Windows bias in several ways. The Windows section appears first and is more detailed in certain areas, with exclusive use of Windows tools (Visual Studio, Windows Explorer, PowerShell scripts) and workflows. The Windows example is tightly coupled to Visual Studio and Windows-specific features (such as installing fonts via Windows Explorer and using PowerShell scripts in Dockerfiles), with no equivalent Linux example for similar scenarios (e.g., custom OS integration, font installation). The Linux section, while comprehensive for a generic Python/Flask app, does not mirror the Windows scenario or provide parity for .NET or custom OS integration use cases.
Recommendations:
- Provide Linux-first or at least parallel Linux and Windows sections, ensuring neither is prioritized in order or detail.
- For every Windows-specific tool or workflow (e.g., Visual Studio, Windows Explorer, PowerShell), provide equivalent Linux instructions (e.g., VS Code, terminal commands, Bash scripts).
- Include a Linux example that demonstrates how to migrate a .NET app with custom OS dependencies (such as custom fonts or libraries) to a Linux container, mirroring the Windows scenario.
- Avoid assuming the user is on Windows by default; ensure all prerequisites and setup steps have Linux equivalents.
- Where PowerShell scripts are used in Dockerfiles for Windows, provide Bash script equivalents for Linux.
- Ensure that screenshots and step-by-step instructions are available for both platforms, not just Windows.
- Explicitly mention any platform-specific limitations or differences, and guide users on how to address them on Linux.
Create pull request
Flagged Code Snippets
FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019
RUN ${source:-obj/Docker/publish/InstallFont.ps1}
14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully