Service Fabric
810
Total Pages
600
Linux-Friendly Pages
210
Pages with Bias
25.9%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
718 issues found
Showing 401-425 of 718 flagged pages
Service Fabric
Service Fabric project creation next steps
...ric/service-fabric-project-creation-next-step-tasks.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Windows Tools
Powershell Heavy
Summary
The documentation page exhibits a notable Windows bias. Tutorials and walk-throughs are exclusively for Windows, with no mention of Linux or macOS equivalents. Examples and quickstarts are labeled as 'on Windows', and deployment instructions reference PowerShell scripts without alternatives for Bash or Linux environments. The 'Next steps' section also prioritizes Windows clusters, with no guidance for Linux cluster creation or management.
Recommendations
- Add Linux/macOS equivalents for all tutorials and walk-throughs, including reliable services, actors, guest executables, and container applications.
- Include deployment instructions and scripts for Bash/CLI alongside PowerShell, or provide cross-platform alternatives.
- Ensure that cluster creation and management guidance covers both Windows and Linux clusters, with parity in examples and links.
- When listing examples or quickstarts, alternate or group by platform, rather than listing Windows first or exclusively.
- Explicitly mention platform support and limitations at the top of the page, so users know if content is Windows-only.
Create Pull Request
Service Fabric
Azure Service Fabric CLI- sfctl chaos
.../articles/service-fabric/service-fabric-sfctl-chaos.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page for 'sfctl chaos' shows evidence of Windows bias primarily in its use of Windows-specific terminology and references. The arguments for time ranges (--start-time-utc, --end-time-utc) are described as 'Windows file time', and the documentation links to .NET's DateTime.ToFileTimeUtc method, which is Windows/.NET-centric. There are no Linux/macOS-specific examples, nor is there any mention of how to obtain or format these time values on non-Windows platforms. The documentation does not provide parity for Linux/macOS users in these critical areas.
Recommendations
- Provide equivalent instructions or examples for generating 'Windows file time' values on Linux/macOS (e.g., using Python, date commands, or other cross-platform tools).
- Add references or links to cross-platform methods for working with time formats required by the CLI.
- Clarify whether the CLI accepts standard Unix timestamps or ISO8601 formats, or provide conversion utilities/scripts.
- Avoid referencing Windows/.NET methods exclusively; include alternatives for other platforms.
- Explicitly state platform compatibility for all arguments and commands.
Service Fabric
Delete a Service Fabric cluster in Azure
...rvice-fabric/service-fabric-tutorial-delete-cluster.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation shows a notable Windows bias: it references only the creation of a Windows cluster, links to Windows-specific cluster management and diagnostics, and omits any mention of Linux clusters or Linux-specific guidance. While the deletion steps use cross-platform Azure CLI and PowerShell, the overall context and examples are Windows-centric, and Linux users may be left uncertain about parity or applicability.
Recommendations
- Explicitly mention and link to instructions for creating and managing Linux-based Service Fabric clusters.
- Include Linux-specific examples or clarify that the deletion steps apply equally to Linux clusters.
- Add references to Linux diagnostics and management tools (e.g., how to patch Linux nodes, aggregate events for Linux clusters).
- Balance the 'Next steps' section with Linux-focused resources and guides.
Service Fabric
Import certificates into a container
...s/service-fabric/service-fabric-securing-containers.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation page exhibits a Windows bias by providing detailed Windows-specific implementation details and code examples, while Linux instructions are less explicit and lack equivalent code samples. Windows terminology and tools (e.g., PFX, ACLs, X509Store) are described in depth, whereas Linux procedures are mentioned only briefly. The only code sample is for Windows, and there is no Linux shell or code example for certificate import.
Recommendations
- Add equivalent Linux code samples (e.g., using OpenSSL or shell scripts) for importing PEM certificates into the container.
- Provide step-by-step instructions for Linux users, including how to handle PEM and private key files inside containers.
- Ensure that Linux-specific environment variables and certificate handling are explained as thoroughly as Windows.
- Balance the order of presentation so that Linux and Windows instructions/examples are given equal prominence.
- Clarify any platform-specific caveats or differences in certificate handling.
Service Fabric
Service Fabric Explorer blocking operations
...ged-cluster-service-fabric-explorer-blocking-operation.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation page predominantly references PowerShell cmdlets (e.g., Remove-AzResource, AzSF PowerShell cmdlet) for managing Service Fabric resources, which are primarily associated with Windows environments. There is no mention of Linux/macOS equivalents, nor are CLI examples (such as Azure CLI) provided for common operations. This creates friction for users on non-Windows platforms who may not use PowerShell.
Recommendations
- Include Azure CLI examples for all operations (e.g., az resource delete, az servicefabric managed-cluster application create) alongside PowerShell cmdlets.
- Explicitly state platform compatibility for each tool or command, clarifying which are cross-platform.
- Add notes or links to Linux/macOS installation guides for required tools.
- Where possible, provide ARM template snippets as platform-neutral alternatives.
Service Fabric
Migrate from Azure Cloud Services to Service Fabric
...ic/cloud-services-to-service-fabric-migration-guide.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page exhibits a notable Windows bias. PowerShell is the only command-line example provided for cluster deployment and application packaging, with no Azure CLI or Bash equivalents. Visual Studio (Windows-only) is the sole IDE mentioned for development, and the 'Prepare your development environment' link points to Windows setup. There are no Linux/macOS-specific instructions or examples for cluster creation, deployment, or development, and Windows-centric tools and workflows are referenced first and exclusively throughout critical migration steps.
Recommendations
- Add Azure CLI and Bash examples for cluster deployment, resource group creation, and application packaging/deployment.
- Include instructions for setting up a Service Fabric development environment on Linux/macOS (e.g., using VS Code, .NET CLI, or JetBrains Rider).
- Reference cross-platform tools and workflows alongside or before Windows-specific ones.
- Provide parity in migration steps and troubleshooting for Linux/macOS users, including links to relevant documentation.
- Explicitly note OS requirements and alternatives for each major step.
Service Fabric
X.509 Certificate-based Authentication in a Service Fabric Cluster
...ticles/service-fabric/cluster-security-certificates.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Powershell Heavy
Missing Linux Example
Summary
The documentation page demonstrates a moderate Windows bias. Windows terminology, tools, and APIs (e.g., Win32 CryptoAPI, Windows certificate store paths, Windows event logs, CAPI1/CNG providers) are mentioned first and in detail, with Linux equivalents only briefly referenced or omitted. Troubleshooting and operational examples are Windows-centric, and there are no explicit Linux/macOS command-line or troubleshooting examples. This may create friction for Linux/macOS users managing Service Fabric clusters.
Recommendations
- Provide explicit Linux/macOS equivalents for certificate store paths, certificate management, and troubleshooting steps (e.g., mention /var/lib/sfcerts, use of openssl, journalctl, syslog, etc.).
- Include Linux/macOS command-line examples for certificate installation, validation, and troubleshooting alongside Windows/Powershell examples.
- Clarify how Service Fabric interacts with certificates on Linux/macOS, including supported crypto providers and any platform-specific limitations.
- Reference Linux/macOS documentation for certificate management and troubleshooting.
- Ensure troubleshooting sections cover Linux/macOS log locations, error codes, and diagnostic tools.
Service Fabric
Deploy an application to a managed cluster using Azure Resource Manager
...bric/how-to-managed-cluster-app-deployment-template.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation page demonstrates a notable Windows bias. All command-line examples for deploying and deleting Service Fabric applications use PowerShell cmdlets (e.g., New-AzResourceGroupDeployment, Get-AzResource, Remove-AzServiceFabricManagedClusterApplication) without mentioning or providing equivalent Azure CLI commands, which are cross-platform. The application packaging workflow is described using Visual Studio, a Windows-centric tool, with no mention of alternatives for Linux/macOS users. There are no Linux/macOS-specific instructions or examples, and Windows tools and patterns are presented exclusively and first.
Recommendations
- Provide Azure CLI equivalents for all PowerShell deployment and deletion commands, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Include instructions for packaging Service Fabric applications using cross-platform tools (e.g., dotnet CLI, SFCTL, or manual zip commands), not just Visual Studio.
- Explicitly mention and demonstrate workflows for Linux/macOS users, including file path conventions and tool installation guidance.
- Reorder examples or provide parallel examples for both Windows and Linux/macOS environments to avoid Windows-first presentation.
- Add notes or links to official documentation for Linux/macOS development environments.
Service Fabric
Manage certificates in a Service Fabric cluster
...vice-fabric/cluster-security-certificate-management.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page exhibits a notable Windows bias. PowerShell is the only scripting language shown for programmatic certificate enrollment, and all automation examples use PowerShell cmdlets. The Key Vault VM extension is described and referenced exclusively in its Windows variant, with no mention of the Linux equivalent or cross-platform alternatives. The documentation references Windows-specific concepts (such as S-channel, ACLing, and certificate store locations like 'LocalMachine' and 'MY') without providing Linux analogs or guidance. Troubleshooting and FAQ sections also omit Linux-specific instructions or examples.
Recommendations
- Provide equivalent Bash/CLI examples for certificate enrollment and management, using Azure CLI or REST API calls that work on Linux/macOS.
- Reference and link to the Key Vault VM extension for Linux, and clarify differences or parity between Windows and Linux extensions.
- Discuss Linux certificate store locations and access control mechanisms (e.g., file permissions, OpenSSL, etc.) alongside Windows concepts like ACLing and S-channel.
- Ensure that automation and scripting examples are available for both PowerShell and Bash/CLI, and present them side-by-side or in separate sections.
- Explicitly state platform-specific limitations or differences, and offer guidance for Linux/macOS users where Windows-only features are discussed.
Service Fabric
Configure managed identity support in an existing Service Fabric cluster
...existing-cluster-enable-managed-identity-token-service.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Summary
The documentation references Service Fabric Explorer (a Windows-centric tool) and the Azure portal for cluster management tasks. It mentions viewing upgrade policies via PowerShell and resources.azure.com, but does not provide Linux/macOS equivalents or CLI examples. Windows tools and patterns are mentioned first or exclusively, with no parity for Linux users.
Recommendations
- Provide equivalent instructions using Azure CLI and/or REST API for all management tasks, including viewing and updating cluster settings.
- Mention cross-platform tools (e.g., Service Fabric CLI, az sf commands) and provide examples for Linux/macOS users.
- Clarify which steps are platform-agnostic and which require Windows-only tools, offering alternatives where possible.
- Include troubleshooting steps that use cross-platform commands, not just portal or PowerShell.
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation page demonstrates a notable Windows bias: it refers to 'custom windows images' exclusively in the introduction, provides only PowerShell (Windows-centric) examples for role assignment, and links to Windows-specific resources before Linux equivalents. Linux examples, tools, and terminology are either missing or referenced secondarily, making it less accessible for Linux/macOS users.
Recommendations
- Include explicit references to both Windows and Linux custom images in the introduction and throughout the documentation.
- Provide equivalent CLI (az CLI) examples for role assignment and other operations alongside PowerShell commands.
- Ensure that links to Linux documentation are presented alongside or before Windows links where appropriate.
- Add ARM template examples and usage notes that clarify any OS-specific differences, especially for Linux-based images.
- Clearly state support for Linux images and provide guidance for their creation and deployment.
Service Fabric
Deploy app with a user-assigned managed identity
...vice-fabric-application-user-assigned-managed-identity.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Summary
The documentation references PowerShell as the primary tool for managing user-assigned managed identities, specifically linking to a PowerShell-centric guide. No Linux or cross-platform CLI alternatives (such as Azure CLI) are mentioned, and the only external tool reference is Windows-specific. However, the main deployment instructions are platform-neutral, focusing on ARM templates and XML manifests.
Recommendations
- Include links and examples for Azure CLI commands to manage user-assigned managed identities, as Azure CLI is cross-platform.
- Reference both PowerShell and CLI documentation when mentioning external guides.
- Explicitly state that ARM template and manifest steps are platform-agnostic.
- Add a note or section for Linux/macOS users, clarifying tool parity and usage.
Service Fabric
Use Application Gateway in a Service Fabric managed cluster
...e-fabric/how-to-managed-cluster-application-gateway.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page provides only PowerShell-based command examples for critical steps such as retrieving service principal information and assigning roles. No CLI, Bash, or Linux/macOS-friendly alternatives are mentioned. PowerShell commands are presented as the default method, and there is no guidance for users on Linux or macOS platforms, which may create friction for non-Windows users.
Recommendations
- Add equivalent Azure CLI (az) command examples for all PowerShell steps, especially for service principal retrieval and role assignment.
- Include Bash script snippets or instructions for Linux/macOS users.
- Clearly indicate that both PowerShell and CLI methods are supported and provide links to relevant cross-platform tooling documentation.
- Consider presenting CLI examples before or alongside PowerShell to avoid Windows-first bias.
Service Fabric
Configure and use applications with managed identity on a Service Fabric managed cluster
...ttps://github.com/MicrosoftDocs/azure-compute-docs/blob/main/articles/service-fabric/how-to-managed-cluster-application-managed-identity.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page shows subtle Windows bias, primarily through references and links to Windows-specific tooling (notably PowerShell) and by omitting Linux/macOS equivalents. The only external command-line example is a link to a PowerShell-based guide for managing user-assigned managed identities, with no mention of Azure CLI or Bash alternatives. No explicit Linux/macOS instructions or examples are provided, and the documentation does not clarify cross-platform compatibility for deployment or management tasks.
Recommendations
- Add Azure CLI and Bash examples for managing user-assigned managed identities alongside PowerShell references.
- Explicitly mention that ARM template deployment and Service Fabric management can be performed from Linux/macOS, and provide links to relevant cross-platform documentation.
- Where external guides are linked (e.g., for creating user-assigned identities), ensure both Windows (PowerShell) and Linux/macOS (Azure CLI) options are presented.
- Consider a section or note on platform-agnostic workflows for Service Fabric managed clusters.
Service Fabric
Deploy a Service Fabric managed cluster across Availability Zones
...ce-fabric/how-to-managed-cluster-availability-zones.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a Windows bias by providing PowerShell-based examples for cluster management tasks (e.g., using Select-AzSubscription and Invoke-AzResourceAction), referencing PowerShell commands for node management, and omitting equivalent CLI or Bash examples for Linux/macOS users. The use of 'Az Module' and explicit PowerShell command links further reinforces this bias. No Linux/macOS-specific instructions or parity examples are given for critical operations.
Recommendations
- Provide Azure CLI (az) command examples alongside or instead of PowerShell for all management tasks, as Azure CLI is cross-platform.
- Explicitly mention that all API calls and ARM template operations can be performed from any OS, and provide Bash/cURL examples for REST API calls.
- Where PowerShell commands are referenced (e.g., az sf cluster node add/remove), clarify that these are available via Azure CLI and show usage in Bash.
- Add a section or callouts for Linux/macOS users, ensuring parity in instructions and tooling.
- Avoid referencing 'Az Module' or PowerShell-specific tooling as the primary or only method for resource management.
Service Fabric
Add Azure Dedicated Host to a Service Fabric managed cluster (SFMC)
...rvice-fabric/how-to-managed-cluster-dedicated-hosts.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a notable Windows bias by exclusively providing PowerShell-based examples and instructions for key deployment and role assignment steps. There are no CLI or Bash examples, and PowerShell is referenced as the primary automation tool, which is most commonly used on Windows. This may create friction for Linux/macOS users who prefer or require cross-platform tools like Azure CLI or Bash scripts.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell commands, especially for authentication, resource group creation, deployment, and role assignment.
- Explicitly mention that ARM template deployments and role assignments can be performed using Azure CLI or REST API, and link to relevant documentation.
- Reorder examples so that cross-platform (CLI, portal) options are presented before or alongside PowerShell.
- Include troubleshooting steps or notes relevant to Linux/macOS environments, such as certificate management or file path conventions.
Service Fabric
Create a Service Fabric managed cluster (SFMC) with Ephemeral OS disks for node types
...ce-fabric/how-to-managed-cluster-ephemeral-os-disks.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation page demonstrates a moderate Windows bias. The only command-line deployment example provided uses PowerShell cmdlets, which are native to Windows. The instructions for admin access reference RDP, a Windows-specific protocol, and the admin credentials are described in a Windows-centric way. No equivalent Linux/macOS CLI (e.g., Azure CLI or Bash) deployment instructions are provided, nor are SSH-based admin access patterns mentioned. Windows tools and terminology are presented first and exclusively.
Recommendations
- Add Azure CLI (az deployment group create) and/or Bash examples for ARM template deployment.
- Include instructions for SSH-based admin access to VMs, and clarify that Linux-based admin accounts are supported.
- Present Windows and Linux/macOS deployment options side-by-side, or alternate which is shown first.
- Explicitly mention cross-platform support and provide links to Linux/macOS tooling documentation.
Service Fabric
Upgrade the configuration of an Azure Service Fabric cluster
...-fabric/service-fabric-cluster-config-upgrade-azure.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation page demonstrates a moderate Windows bias by listing PowerShell-based methods and tools before their Azure CLI equivalents, and by referencing Windows-centric tooling (PowerShell cmdlets) more prominently. While Azure CLI options are mentioned, PowerShell commands are given more detail and appear first, which may create friction for Linux/macOS users who are more likely to use CLI. No explicit Linux/macOS examples or guidance are provided.
Recommendations
- Present Azure CLI and PowerShell options in parallel, with equal detail and prominence.
- Add explicit examples for Linux/macOS users, such as CLI commands run in bash.
- Clarify that all operations can be performed cross-platform using Azure CLI.
- Avoid listing PowerShell commands before CLI commands unless there is a technical reason.
- Include notes or links for installing and using Azure CLI on Linux/macOS.
Service Fabric
Deploy application secrets to a Service Fabric managed cluster
...e-fabric/how-to-managed-cluster-application-secrets.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page exhibits a moderate Windows bias. It references Windows-specific tools (such as the Key Vault VM extension for Windows), omits explicit Linux/macOS instructions or examples, and links primarily to Windows-focused resources. There are no PowerShell-only examples, but the lack of Linux parity in certificate installation and management steps may create friction for non-Windows users.
Recommendations
- Include explicit instructions and examples for Linux and macOS environments, especially for certificate installation and management.
- Reference and link to the Key Vault VM extension for Linux (if available), or provide alternative steps for Linux clusters.
- Clarify whether the 'certificate store' concept applies to Linux nodes and, if so, provide guidance on equivalent locations and commands.
- Present cross-platform CLI examples (e.g., Azure CLI, bash) alongside or before Windows-specific tools.
- Add a section or note addressing Linux/macOS users and any differences in workflow.
Service Fabric
Enable Disk Encryption for Service Fabric managed cluster nodes
...abric/how-to-managed-cluster-enable-disk-encryption.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation page exhibits a notable Windows bias. The introduction and instructions focus on enabling disk encryption for Service Fabric managed cluster nodes 'in Windows'. All deployment and verification examples use PowerShell commands, and references point to Windows-specific documentation. While Azure CLI is briefly mentioned for Key Vault steps, the overall workflow, including cluster deployment and status verification, is presented only with PowerShell. There is no guidance or examples for Linux/macOS users, nor is there mention of Linux-specific tooling or patterns for cluster management.
Recommendations
- Add explicit instructions and examples for Linux/macOS users, including Bash/Azure CLI equivalents for all PowerShell commands.
- Reference Linux-specific documentation where appropriate, especially for disk encryption verification and management.
- Clarify which steps are OS-agnostic and which require Windows, and provide alternatives for non-Windows platforms.
- Present Azure CLI and Bash examples alongside PowerShell, or in a tabbed format, for all deployment and verification steps.
- Update the page title and description to reflect cross-platform applicability if supported.
Service Fabric
Set up IP tags on a Service Fabric managed cluster
...icles/service-fabric/how-to-managed-cluster-ip-tags.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Missing Linux Example
Summary
The documentation references provisioning IP tags using a PowerShell module (Az.Network), which is a Windows-centric tool, and does not provide equivalent instructions or examples for Linux/macOS users (e.g., Azure CLI or REST API). No Linux/macOS-specific guidance or parity is offered.
Recommendations
- Include instructions and examples for provisioning IP tags using Azure CLI, which is cross-platform.
- Reference REST API methods for provisioning IP tags, suitable for all platforms.
- Explicitly state that PowerShell is one option and provide alternatives for Linux/macOS users.
- Add links to Azure CLI documentation for creating public IP addresses with IP tags.
Service Fabric
Configure a Service Fabric managed cluster to use a NAT gateway
...s/service-fabric/how-to-managed-cluster-nat-gateway.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides example commands for Azure CLI, Azure PowerShell, ARM templates, and the Azure portal. However, the PowerShell example is detailed and multi-step, while the Azure CLI example is a single command with minimal explanation. There is no mention of Linux/macOS-specific considerations, nor is there parity in example depth for CLI usage on Linux. PowerShell is a Windows-centric tool, and its example is given more prominence and detail than the CLI, which is cross-platform. The ordering of examples also places PowerShell before the portal, which is more OS-neutral.
Recommendations
- Expand the Azure CLI section to include step-by-step instructions equivalent to the PowerShell example, ensuring Linux/macOS users have clear guidance.
- Explicitly mention that Azure CLI is cross-platform and suitable for Linux/macOS users.
- Add notes or links for installing and using Azure CLI on Linux/macOS.
- Consider reordering examples to present CLI before PowerShell, or group them as 'cross-platform' and 'Windows-specific'.
- If PowerShell Core is supported on Linux/macOS, clarify this and provide installation guidance.
Service Fabric
Configure or modify a Service Fabric managed cluster node type
...vice-fabric/how-to-managed-cluster-modify-node-type.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation consistently provides PowerShell examples for command-line operations (add/remove/scale/configure node types), but does not offer equivalent examples for Linux/macOS users (e.g., Azure CLI, Bash, or cross-platform scripting). PowerShell is a Windows-centric tool, and its exclusive use creates friction for users on other platforms. Additionally, PowerShell examples are presented before any mention of alternatives, and no Linux/macOS-specific instructions or notes are provided.
Recommendations
- Add Azure CLI examples for all command-line operations alongside PowerShell, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Explicitly mention that PowerShell Core is available for Linux/macOS, if relevant, and provide installation guidance or links.
- Where possible, provide Bash script examples or note how ARM template deployments can be performed using Azure CLI on any OS.
- Structure command-line sections to present cross-platform options first, or in parallel, rather than defaulting to Windows/PowerShell.
- Add a note clarifying platform compatibility for all tools mentioned.
Service Fabric
Configure network settings for Service Fabric managed clusters
...es/service-fabric/how-to-managed-cluster-networking.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation demonstrates a moderate Windows bias, primarily through the exclusive use of PowerShell for all command-line examples, frequent references to Windows-specific concepts (such as RDP and Remote Desktop Connection), and the absence of equivalent Linux/macOS CLI or tooling instructions. Windows clusters and tools are mentioned first or exclusively in several sections, and screenshots are Windows-centric. Linux users are left to infer how to adapt instructions, which may create friction but does not block completion of tasks.
Recommendations
- Provide Azure CLI (az) command examples alongside PowerShell for all resource management tasks, especially for role assignments, resource group creation, and deployments.
- Include SSH instructions and screenshots for remote access to Linux-based clusters, in addition to RDP/Windows examples.
- Clarify which steps and properties apply to Linux clusters, and note any differences in port mappings, NAT rules, or networking behavior.
- Add explicit guidance for Linux/macOS users on how to verify public IPs, connect to nodes, and deploy ARM templates using cross-platform tools.
- Reorder sections or examples so that Windows and Linux approaches are presented with equal prominence.
Service Fabric
Add a managed identity to a Service Fabric managed cluster node type
...ed-identity-managed-cluster-virtual-machine-scale-sets.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a notable Windows bias. All command-line examples use PowerShell cmdlets (New-AzResourceGroup, New-AzUserAssignedIdentity, etc.) with no equivalent Azure CLI or Bash examples for Linux/macOS users. The VM image example uses Windows-specific values (MicrosoftWindowsServer, WindowsServer, 2019-Datacenter) without mention of Linux alternatives. The troubleshooting section references the Azure portal but does not discuss cross-platform command-line troubleshooting. There is no guidance for users who prefer or require Linux/macOS tools.
Recommendations
- Add Azure CLI examples alongside PowerShell for all resource creation and deployment steps.
- Include ARM template snippets for Linux node types (e.g., using Ubuntu or other Linux images).
- Explicitly mention Linux/macOS compatibility and provide Bash/CLI commands where possible.
- Reorder examples so that cross-platform (ARM template, Azure CLI) options are shown before or alongside PowerShell.
- Add troubleshooting steps using Azure CLI for role assignments and identity management.