Planetary Computer

42
Total Pages
30
Linux-Friendly Pages
12
Pages with Bias
28.6%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

32 issues found
Showing 26-32 of 32 flagged pages
Planetary Computer https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/planetary-computer/api-tutorial.md .../blob/main/articles/planetary-computer/api-tutorial.md
Medium Priority View Details →
Scanned: 2025-07-12 23:44
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a Windows-first bias by recommending Azure Machine Learning Virtual Machine and Visual Studio Code (VS Code) as primary environments, both of which are commonly used on Windows. The only explicit CLI authentication example uses the Azure CLI, but there is no mention of Linux-specific environments, nor are there any examples or troubleshooting tips for Linux users. There are no PowerShell-specific commands, but the lack of Linux/macOS parity in environment setup and tool recommendations is notable.
Recommendations
  • Explicitly mention that the tutorial is compatible with Linux and macOS environments, not just Windows.
  • Provide example commands for setting up the environment on Linux (e.g., using apt or yum to install Azure CLI, Python, and pip).
  • Include alternative recommendations for running Jupyter notebooks, such as JupyterLab or command-line Jupyter, which are cross-platform.
  • Add troubleshooting notes for common Linux/macOS issues (e.g., Azure CLI authentication, file permissions).
  • Clarify that Visual Studio Code is available on all platforms, and provide instructions for installing it on Linux/macOS.
  • Consider including a table or section comparing setup steps for Windows, Linux, and macOS users.
GitHub Create Pull Request
Planetary Computer https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/planetary-computer/get-started-planetary-computer.md ...s/planetary-computer/get-started-planetary-computer.md
Medium Priority View Details →
Scanned: 2025-07-12 23:44
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation page demonstrates a Windows/Azure portal-first bias: all deployment and management instructions are given via the Azure web portal, with no mention of command-line alternatives (such as Azure CLI or Bicep), which are commonly used on Linux and cross-platform environments. There are no PowerShell-specific examples, but the lack of Linux/CLI parity is notable. No Linux tools, shell commands, or platform-agnostic automation methods are referenced, and the workflow assumes a GUI-first approach typical of Windows users.
Recommendations
  • Add parallel instructions for deploying and managing GeoCatalog resources using Azure CLI and/or Bicep, including example commands.
  • Include examples of interacting with the service via REST API using curl or similar cross-platform tools.
  • Explicitly mention that all steps can be performed from Linux, macOS, or Windows, and provide links to CLI installation/setup guides.
  • Where screenshots are shown of the Azure portal, consider also providing CLI output or code snippets to ensure parity.
  • Highlight any platform-specific requirements or limitations, if any, and provide workarounds.
GitHub Create Pull Request
Planetary Computer https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/planetary-computer/bulk-ingestion-api.md ...main/articles/planetary-computer/bulk-ingestion-api.md
Medium Priority View Details →
Scanned: 2025-07-12 23:44
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Missing Linux Example
Summary
The documentation assumes the use of Azure CLI and AzureCliCredential for authentication, which are primarily Windows-centric tools and patterns. There are no explicit Linux or cross-platform command-line examples (e.g., Bash, Linux authentication alternatives), and no mention of Linux-specific considerations or parity. All code and instructions are platform-agnostic Python, but the authentication and tooling context is Azure CLI, which is more familiar to Windows/PowerShell users. No Linux-first or Linux-alternative authentication flows are described.
Recommendations
  • Explicitly mention that Azure CLI is cross-platform and provide installation instructions for Linux and macOS, not just a link to the Azure CLI docs.
  • Include alternative authentication methods suitable for Linux environments, such as using environment variables with service principal credentials (AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET) and show example code.
  • Add a note or section on running the workflow in a Linux shell (Bash), including any differences in environment setup or permissions.
  • Where possible, provide both Windows (PowerShell/CMD) and Linux (Bash) command-line snippets for prerequisite steps (e.g., installing Python, Azure CLI).
  • Clarify that all Python code is cross-platform, but highlight any OS-specific caveats if they exist.
GitHub Create Pull Request
Planetary Computer https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/planetary-computer/manage-access.md ...blob/main/articles/planetary-computer/manage-access.md
Medium Priority View Details →
Scanned: 2025-07-12 23:44
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Missing Linux Example Windows First
Summary
The documentation exclusively describes managing user access via the Azure Portal GUI, with no mention of command-line tools or automation options. There are no examples for command-line interfaces such as Azure CLI, PowerShell, or Bash, nor any Linux-specific instructions. The overall approach assumes a graphical, point-and-click workflow, which is more common in Windows environments and less typical for Linux users who often prefer CLI-based management.
Recommendations
  • Add step-by-step instructions for assigning RBAC roles using the Azure CLI (az role assignment), including example commands.
  • If relevant, provide PowerShell examples, but ensure that Azure CLI (cross-platform) examples are presented first or alongside.
  • Explicitly mention that all CLI instructions work on Linux, macOS, and Windows.
  • Include a section comparing GUI and CLI approaches, highlighting the benefits of automation and scripting for Linux users.
  • Link to official Azure CLI documentation for managing RBAC and user access.
GitHub Create Pull Request
Planetary Computer https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/planetary-computer/set-up-ingestion-credentials-managed-identity.md ...puter/set-up-ingestion-credentials-managed-identity.md
Medium Priority View Details →
Scanned: 2025-07-12 23:44
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Missing Linux Example 🔧 Windows Tools
Summary
The documentation exclusively uses the Azure Portal (a web-based GUI) for all configuration steps and does not provide any command-line examples. There are no references to cross-platform CLI tools (such as Azure CLI or Azure PowerShell), nor are there any Linux-specific instructions or examples. The absence of CLI instructions implicitly favors Windows users, as the Azure Portal experience is often more familiar or accessible to them, and omits parity for Linux users who may prefer or require command-line automation.
Recommendations
  • Add equivalent Azure CLI commands for each step (creating managed identities, assigning roles, associating identities, configuring ingestion sources). The Azure CLI is cross-platform and works on Linux, macOS, and Windows.
  • Where relevant, provide Azure PowerShell examples as an alternative, but always include Azure CLI as the primary or at least as a parallel option.
  • Explicitly mention that all steps can be performed via CLI and provide links to relevant Azure CLI documentation.
  • Include a section or callout for Linux/macOS users, highlighting that all operations can be performed from their platforms using the CLI.
  • Ensure screenshots or instructions do not assume a Windows environment (e.g., avoid referencing Windows-specific file paths or UI conventions).
GitHub Create Pull Request
Planetary Computer Assign Managed Identity to GeoCatalog in Microsoft Planetary Computer Pro via the CLI ...omputer/assign-managed-identity-geocatalog-resource.md
Low Priority View Details →
Scanned: 2026-01-14 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy 🔧 Windows Tools
Summary
The documentation presents both PowerShell (Windows) and Bash (Linux/macOS) examples, but the PowerShell tab and instructions are shown first. The script saving instructions reference Notepad (Windows tool) before Notepad++ (Windows) and VS Code (cross-platform), and the Bash instructions mention running via WSL (Windows Subsystem for Linux) before other Bash environments, subtly prioritizing Windows workflows. There is no missing Linux example, but the ordering and tool references show a mild Windows bias.
Recommendations
  • Present Bash and PowerShell tabs in alphabetical or neutral order, or randomize which is shown first.
  • In script saving instructions, mention cross-platform editors (e.g., VS Code, Sublime Text) before Windows-specific ones.
  • For Bash, recommend native Linux/macOS terminals first, then mention WSL as an option for Windows users.
  • Ensure all instructions are equally detailed and platform-neutral where possible.
GitHub Create Pull Request
Planetary Computer Assign Managed Identity to GeoCatalog in Microsoft Planetary Computer Pro via the CLI ...omputer/assign-managed-identity-geocatalog-resource.md
Low Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy 🔧 Windows Tools
Summary
The documentation presents both PowerShell (Windows) and Bash (Linux/macOS) examples for assigning a managed identity, but the PowerShell tab and instructions are listed first. The script-saving instructions reference Notepad (Windows) before VS Code, and the Bash instructions mention Notepad++ (Windows) before VS Code. The Bash section suggests running scripts via WSL, which is a Windows-centric pattern, rather than directly referencing native Linux/macOS terminals. There is a slight preference for Windows tools and workflows throughout.
Recommendations
  • Alternate the order of PowerShell and Bash tabs or present Bash first to avoid implicit prioritization of Windows.
  • In script-saving instructions, mention cross-platform editors (e.g., VS Code, nano, vim) before Windows-specific editors like Notepad or Notepad++.
  • In Bash instructions, recommend running scripts directly in native Linux/macOS terminals, not just via WSL.
  • Add explicit notes that both scripts work on macOS and Linux, and clarify any platform-specific differences if present.
  • Consider adding a table or section summarizing platform compatibility and prerequisites for each environment.
GitHub Create Pull Request
← Previous Page 2 of 2 Next →