Document Details
Tutorial App Containerization Azure Pipeline
❌
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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by referencing only Windows file paths (e.g., C:\ProgramData\...), using Windows-specific navigation instructions (File Explorer, 'Hidden items'), and omitting equivalent Linux instructions or file paths. There are no examples or guidance for users running the App Containerization tool or accessing artifacts on Linux systems, despite mentioning Linux deployments in the 'Next steps' section. The focus on Windows tools and patterns may hinder Linux users from following the tutorial effectively.
Recommendations:
- Include Linux file paths and navigation instructions alongside Windows examples (e.g., /var/lib/azure-migrate-app-containerization or similar).
- Provide guidance for accessing hidden directories and files on Linux (e.g., using ls -a or similar commands).
- Explicitly state whether the Azure Migrate App Containerization tool is supported on Linux, and if so, provide Linux-specific steps for locating artifacts.
- Balance the order of presentation by mentioning Linux and Windows artifact locations together, or in parallel sections.
- Where screenshots or UI instructions are given (e.g., File Explorer), offer Linux equivalents (e.g., Nautilus, command line).
Create pull request