Detected Bias Types
Windows First
Missing Linux Example
🔧
Windows Tools
Powershell Heavy
Summary
The documentation is heavily focused on Windows-specific concepts, terminology, and examples. Windows environment variables (%SystemDrive%, %ResourceDrive%, %HOME%), Windows file paths (d:\, c:\), IIS, ASP.NET, COM components, PowerShell, and Windows registry access are described in detail, while Linux equivalents are either missing or only briefly mentioned. Linux is referenced only in a note, with no substantive examples or parity in explanations. Diagnostic logging and registry sections are Windows-centric, and tools like Kudu and Web Deploy are described only in a Windows context.
Recommendations
- Add equivalent Linux examples and terminology throughout, such as $HOME, /tmp, and Linux filesystem paths.
- Describe how file access, network access, and process execution work for Linux-based App Service apps, including container specifics.
- Include Linux-specific diagnostic logging options and clarify which Windows-only features (like ETW, registry) are not available or have Linux alternatives.
- Provide parity in troubleshooting and deployment examples, e.g., using SCP, rsync, or Linux CLI tools alongside Web Deploy and PowerShell.
- Explicitly state differences and similarities between Windows and Linux App Service environments in each section, not just in a single note.