Document Details
Apache Spark Livy Rest Interface
❌
This page contains Windows bias
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
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by providing environment variable examples and file path conventions specific to Windows (e.g., set commands, C:\Temp\input.txt), and by recommending the use of AzCopy (a Microsoft tool) for file uploads without mentioning Linux alternatives. There are no explicit Linux/macOS shell examples (e.g., export, $HOME/input.txt), and the guidance for adapting commands to non-Windows environments is minimal and non-specific.
Recommendations:
- Provide parallel Linux/macOS shell examples for setting environment variables (e.g., export clustername=CLUSTERNAME) and for file paths (e.g., ~/input.txt).
- Explicitly mention and demonstrate how to use Linux-native tools for uploading files, such as Azure CLI (az storage blob upload) or standard SCP/rsync.
- When referencing input files, show both Windows (C:\Temp\input.txt) and Linux/macOS (~/<path>/input.txt) formats.
- Instruct users on how to adapt the curl commands for bash/zsh shells, including variable substitution (e.g., $clustername, $password).
- Where Windows-specific recommendations are made (e.g., 'using an input file is the recommended approach'), clarify if this is also true for Linux/macOS or provide alternative best practices.
- Add a note or section explicitly addressing cross-platform usage, highlighting any differences or considerations for Linux/macOS users.
Create pull request