Energy Data Services
53
Total Pages
41
Linux-Friendly Pages
12
Pages with Bias
22.6%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
31 issues found
Showing 26-31 of 31 flagged pages
Energy Data Services
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/energy-data-services/tutorial-reservoir-ddms-websocket.md
...rgy-data-services/tutorial-reservoir-ddms-websocket.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation introduces the tutorial as using PowerShell to work with Reservoir DDMS APIs, suggesting a Windows-first approach. However, all provided command-line examples use Bash and Docker, which are cross-platform, but the initial framing may mislead Linux or Mac users into thinking the tutorial is Windows-centric.
Recommendations
- Remove or generalize the reference to PowerShell in the introduction. Instead, state that the tutorial uses cross-platform command-line tools.
- Explicitly mention that the Bash and Docker commands work on Linux, macOS, and Windows (with WSL or compatible terminals).
- If there are any platform-specific steps (such as Docker Desktop installation), provide links or notes for both Windows and Linux/macOS users.
- Consider providing PowerShell equivalents only if there are Windows-specific nuances, otherwise keep examples in Bash for maximum portability.
Create Pull Request
Energy Data Services
Deploy Geospatial Consumption Zone on top of Azure Data Manager for Energy using Azure portal
...includes/how-to/how-to-deploy-gcz/deploy-gcz-on-aks.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Unix Shell and Windows PowerShell examples for all critical steps, ensuring parity. However, in each section, the Unix Shell example is presented before the Windows PowerShell example, which is a minor 'windows_first' bias. The PowerShell examples are thorough and not limited to trivial steps, indicating a 'powershell_heavy' approach, but this is balanced by equivalent Unix Shell content. No exclusive use of Windows tools or missing Linux examples is detected.
Recommendations
- Consider alternating the order of examples or explicitly stating that both Unix Shell and PowerShell are equally supported.
- Add a short note clarifying that all steps are fully supported on Linux/macOS and Windows.
- Ensure that any future updates maintain parity and do not introduce Windows-only tooling or instructions.
Energy Data Services
Deploy Geospatial Consumption Zone on top of Azure Data Manager for Energy using Azure portal
...includes/how-to/how-to-deploy-gcz/deploy-gcz-on-aks.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Unix Shell and Windows PowerShell examples for variable definition and file creation, ensuring parity in most steps. However, Windows PowerShell examples are given equal prominence and sometimes appear before Unix Shell examples. The use of PowerShell-specific constructs (e.g., Out-File, here-strings) may be less familiar to Linux/macOS users, but Unix Shell alternatives are present. There are no Windows-only tools or steps, and Linux/macOS users can complete all tasks using the provided Unix Shell instructions.
Recommendations
- Ensure Unix Shell examples are presented first, as Linux/macOS are the default environments for Kubernetes and Helm workflows.
- Add a note clarifying that all steps are cross-platform and that Unix Shell instructions apply to macOS as well as Linux.
- Consider grouping platform-specific instructions under clear headings to avoid confusion.
- Where possible, use platform-neutral commands (e.g., avoid PowerShell-specific syntax unless necessary).
Energy Data Services
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/energy-data-services/how-to-integrate-elastic-logs-with-azure-monitor.md
...es/how-to-integrate-elastic-logs-with-azure-monitor.md
Low Priority
View Details →
Detected Bias Types
Missing Linux Example
Summary
The documentation provides only Azure Portal (GUI) instructions and screenshots, with no command-line examples for either Windows (PowerShell/Command Prompt) or Linux (Bash/CLI). However, it implicitly favors Windows by referencing Visual Studio Code as the code editor and omitting any mention of Linux tools, CLI commands, or cross-platform workflows. There are no examples or guidance for users who prefer or require Linux-based automation or scripting.
Recommendations
- Add Azure CLI examples for enabling diagnostic settings and downloading logs, as Azure CLI is cross-platform and widely used on Linux.
- Include sample Bash commands for downloading blobs from Azure Storage (e.g., using az storage blob download or tools like wget/curl with SAS URLs).
- Mention and provide examples for opening JSON logs with common Linux editors (e.g., nano, vim, less, jq) in addition to Visual Studio Code.
- Explicitly state that all steps can be performed on Linux, macOS, or Windows, and provide parity in instructions where possible.
- Where screenshots are used, consider including CLI output or terminal screenshots to complement GUI steps.
Energy Data Services
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/energy-data-services/how-to-integrate-osdu-service-logs-with-azure-monitor.md
...ps://github.com/MicrosoftDocs/azure-docs/blob/main/articles/energy-data-services/how-to-integrate-osdu-service-logs-with-azure-monitor.md
Low Priority
View Details →
Detected Bias Types
Missing Linux Example
Summary
The documentation provides only GUI-based instructions and KQL query examples, with no mention of command-line tools, scripts, or workflows for either Windows or Linux. However, there is a lack of parity for Linux users in that there are no CLI (e.g., Azure CLI, Bash) or automation examples, which are commonly used in Linux environments. There is also no mention of PowerShell or Windows-specific tools, so explicit Windows bias is minimal, but the absence of Linux/CLI examples may disadvantage Linux users.
Recommendations
- Add Azure CLI command examples for configuring diagnostic settings and exporting logs, as Azure CLI is cross-platform and widely used in Linux environments.
- Include sample Bash scripts for automating log export or querying operations.
- Mention how to access and analyze logs from the storage account using Linux tools (e.g., azcopy, jq, grep).
- Clarify that all steps can be performed from any OS using the Azure Portal, but provide parity by showing how to accomplish the same tasks via CLI for users who prefer or require non-GUI workflows.
Energy Data Services
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/energy-data-services/tutorial-manifest-ingestion.md
...es/energy-data-services/tutorial-manifest-ingestion.md
Low Priority
View Details →
Detected Bias Types
Missing Linux Example
Summary
The documentation exclusively demonstrates manifest-based file ingestion using the Postman desktop app, without providing any command-line or scripting examples (such as curl, HTTPie, or shell scripts) that would be more familiar or accessible to Linux users. There is no mention of Linux-specific tools or workflows, nor are there instructions for performing the same tasks outside of a GUI environment. This may disadvantage users who prefer or require non-GUI, scriptable, or Linux-native approaches.
Recommendations
- Provide equivalent examples using command-line tools such as curl or HTTPie for each API call demonstrated in Postman.
- Include sample shell scripts (bash) to automate the ingestion workflow, making it easier for Linux users to follow along.
- Mention that the API can be accessed from any platform and that Postman is just one of several possible tools.
- If possible, provide instructions for installing and using Postman on Linux, or suggest alternative Linux-friendly API clients.
- Ensure that any downloadable resources (such as sample files) are accessible and usable from the Linux command line.