Page-Level Analysis
Windows First
Missing Linux Example
Summary:
The documentation demonstrates a Windows bias by specifying 'Windows' as the operating system in the App Service creation step, without mentioning Linux as an option or providing equivalent instructions/examples for Linux-based App Service apps. There are no Linux-specific notes, nor are there alternative steps or clarifications for users deploying on Linux. All examples and configuration steps implicitly assume a Windows environment.
Recommendations:
- Explicitly mention that App Service supports both Windows and Linux, and provide guidance for both.
- In the 'Configure the Basics tab' section, include a table row for 'Operating System' that lists both 'Windows' and 'Linux' as valid options, with notes on any differences.
- If there are any differences in deployment, environment variable configuration, or logging between Windows and Linux App Service, provide parallel instructions or callouts.
- Add a note clarifying that the sample app and SRE Agent work on both Windows and Linux App Service plans, or specify any limitations.
- Where screenshots or UI steps differ between Windows and Linux, provide both or clarify the differences.