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
Summary:
The documentation is generally cross-platform, but there are subtle Windows biases. In several places, Windows-specific tools or patterns are mentioned first or exclusively (e.g., PowerShell, Windows environment variable delimiters, and Windows-specific settings like WEBSITE_NODE_DEFAULT_VERSION). PowerShell is listed as a first-class language, and some settings (like AzureWebJobs_TypeScriptPath) use Windows path syntax. In a few cases, Windows-specific behaviors or settings are described in more detail than Linux equivalents. However, Linux is referenced in many places, and Linux-specific settings are present, but parity in examples and ordering could be improved.
Recommendations:
- When listing environment variable delimiters or behaviors, always present Linux and Windows equally (e.g., mention both colon and double-underscore, and clarify differences).
- For settings that have OS-specific values (like WEBSITE_TIME_ZONE), always provide both Windows and Linux examples side by side.
- Avoid using Windows path syntax (e.g., %HOME%\typescript) in examples unless also providing the Linux equivalent (e.g., $HOME/typescript).
- When referencing tools for managing settings (e.g., Azure CLI, Azure PowerShell), list cross-platform tools first or equally, and avoid suggesting PowerShell as the default.
- For settings that are Windows-only (like WEBSITE_NODE_DEFAULT_VERSION), clearly label them and, where possible, provide the Linux alternative or clarify the Linux behavior.
- Review ordering of language runtimes and examples to ensure Linux-native languages and tools (e.g., bash, Python) are not always listed after Windows/PowerShell.
- Where PowerShell is referenced for dependency management or configuration, provide equivalent bash or shell script examples for Linux users.
Create pull request