Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation page presents instructions for connecting AWS and GCP to Azure via the multicloud connector, but all example workflows for uploading templates and configuring access are described using graphical portals (Azure portal, AWS CloudFormation console, GCP Console/Cloud Shell). There are no explicit examples or command-line instructions for Linux users (e.g., using AWS CLI, gcloud CLI, or Terraform from a Linux shell). The only mention of running Terraform locally refers to Azure Cloud Shell, which is typically a Bash environment, but this is not highlighted or explained for Linux parity. There is no mention of Powershell, but the overall approach assumes users are comfortable with web portals and does not provide parity for Linux command-line workflows.
Recommendations
- Add explicit Linux CLI instructions for uploading CloudFormation templates to AWS (using aws CLI) and running Terraform for GCP (using gcloud CLI and terraform CLI).
- Provide example commands for each major step (e.g., creating stacks, uploading templates, assigning IAM roles) using CLI tools on Linux.
- Clarify that Azure Cloud Shell is Bash-based and suitable for Linux users, and provide equivalent instructions for running commands locally on Linux.
- Include troubleshooting tips for common Linux environments (e.g., Ubuntu, CentOS) when running Terraform or gcloud CLI.
- Ensure parity by listing both portal and CLI workflows side-by-side, so users can choose their preferred method regardless of OS.
Create Pull Request