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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias by recommending Azure Machine Learning Virtual Machine and Visual Studio Code (VS Code) as primary environments, both of which are commonly used on Windows. The only explicit CLI authentication example uses the Azure CLI, but there is no mention of Linux-specific environments, nor are there any examples or troubleshooting tips for Linux users. There are no PowerShell-specific commands, but the lack of Linux/macOS parity in environment setup and tool recommendations is notable.
Recommendations:
- Explicitly mention that the tutorial is compatible with Linux and macOS environments, not just Windows.
- Provide example commands for setting up the environment on Linux (e.g., using apt or yum to install Azure CLI, Python, and pip).
- Include alternative recommendations for running Jupyter notebooks, such as JupyterLab or command-line Jupyter, which are cross-platform.
- Add troubleshooting notes for common Linux/macOS issues (e.g., Azure CLI authentication, file permissions).
- Clarify that Visual Studio Code is available on all platforms, and provide instructions for installing it on Linux/macOS.
- Consider including a table or section comparing setup steps for Windows, Linux, and macOS users.
Create pull request