Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates several types of Windows bias. Visual Studio (Windows-only) is presented first and most extensively, with detailed step-by-step instructions and screenshots. PowerShell is given a dedicated section, and its usage is recommended for Windows hosting, while Linux deployment is relegated to Azure CLI or other tools. Many examples and screenshots use Windows paths and tools (e.g., Compress-Archive, cd bin\Release\net10.0\publish), and there are no equivalent Linux shell or cross-platform examples for tasks like zipping and publishing. The .NET Framework 4.8 workflow is exclusively Windows, and the portal instructions default to Windows for GitHub Actions deployment. Linux is often mentioned as an alternative, but not given equal prominence or example depth.
Recommendations
- Provide Linux shell (bash) equivalents for all PowerShell commands, especially for tasks like zipping and publishing.
- Include screenshots and instructions for Linux environments (e.g., Ubuntu, WSL) alongside Windows examples.
- Present cross-platform tools (Azure CLI, VS Code) before or alongside Windows-only tools (Visual Studio, PowerShell) in each section.
- Clarify when steps are OS-specific, and offer parity in guidance for both Windows and Linux users.
- Ensure that Linux deployment options (including GitHub Actions for Linux) are described with the same detail and priority as Windows.
- Avoid recommending PowerShell as the default for app creation; instead, suggest Azure CLI or other cross-platform tools for both Windows and Linux.
- Add explicit instructions for Linux users to create and compress deployment archives, and publish them using CLI tools.
Create Pull Request