Scan Details - Linux-first Docs for Azure

150

Pages Scanned

Pages Flagged

150

Changed Pages

3.3%

% Pages Flagged

Live Progress

🔴 Connecting...

Phase: discovery

Processing: Initializing...

Activity Feed

21:11:46 Scan started

Scan Information

Started At: 2025-07-13 21:11:46

Finished At: In Progress

Status: cancelled

Target URL: https://github.com/MicrosoftDocs/azure-docs/tree/main/articles

Current Phase: discovery

Problematic Pages

Bias Types:

⚠️ powershell_heavy

⚠️ windows_tools

⚠️ missing_linux_example

Summary:

The documentation provides a PowerShell example for configuring password expiry duration using the Microsoft Graph PowerShell module, but does not offer equivalent command-line examples for Linux/macOS users (e.g., using Azure CLI, Bash, or REST with curl). The documentation also references PowerShell cmdlets and modules without mentioning cross-platform alternatives, which may disadvantage users on non-Windows systems.

Recommendations:

Provide equivalent examples using Azure CLI or direct REST API calls with curl, which are cross-platform and accessible to Linux/macOS users.
Explicitly mention that the Microsoft Graph PowerShell module is available cross-platform (if true), or clarify any OS limitations.
Where PowerShell is used, add a parallel example using Bash/curl for REST API operations.
Review all step-by-step instructions to ensure they do not assume use of Windows-specific tools or interfaces.
Add a note or section on how to perform these tasks from Linux/macOS environments, including installation instructions for any required tools.

Create pull request

Bias Types:

⚠️ windows_tools

⚠️ missing_linux_example

Summary:

The documentation page mentions Microsoft PowerShell as an example HTTP client for testing the POST request, but does not mention any Linux or cross-platform alternatives (such as curl or HTTPie). No command-line examples are provided, and the only tool explicitly referenced is Windows-centric. This may make Linux or macOS users feel unsupported or unclear about how to proceed.

Recommendations:

Mention cross-platform HTTP clients such as curl or HTTPie alongside PowerShell.
Provide example commands for both PowerShell and curl to demonstrate how to make the POST request on different platforms.
Explicitly state that any HTTP client can be used, and provide at least one example for a non-Windows environment.
Consider including a table or section listing common tools for Windows, Linux, and macOS to ensure parity.

Create pull request

Bias Types:

⚠️ windows_first

⚠️ missing_linux_example

Summary:

The documentation demonstrates a subtle Windows bias by referencing Visual Studio as the first development environment and not providing explicit Linux-specific instructions or examples. While Visual Studio Code is mentioned (which is cross-platform), there are no explicit Linux or macOS setup or run instructions, nor are there any terminal commands or troubleshooting tips specific to non-Windows environments. All examples and guidance assume a Windows-like environment, especially in terms of file paths and tool usage.

Recommendations:

Explicitly mention Linux and macOS as supported platforms in the prerequisites and throughout the guide.
Provide Linux/macOS-specific instructions for installing .NET SDK, running the sample, and handling file paths.
Include terminal commands for building and running the application using the dotnet CLI, not just via Visual Studio or Visual Studio Code GUIs.
Add troubleshooting tips for common Linux/macOS issues (e.g., permissions, HTTPS certificates, path length differences).
Ensure screenshots and file path examples are not Windows-specific, or provide alternatives for other platforms.

Create pull request

Bias Types:

⚠️ windows_tools

⚠️ missing_linux_example

Summary:

The documentation references Microsoft-specific tools and APIs (Azure portal, Microsoft Graph PowerShell SDK) without mentioning or providing parity for Linux or cross-platform alternatives. There are no Linux-specific instructions or examples, and the only programmatic example references PowerShell, which is traditionally associated with Windows, though it is now cross-platform. There is no mention of Linux command-line tools or workflows.

Recommendations:

Explicitly mention that Microsoft Graph PowerShell SDK is cross-platform and provide installation/use instructions for Linux/macOS.
Include examples using Microsoft Graph API with curl or other command-line tools available on Linux.
Clarify that the Azure portal is web-based and accessible from any OS.
Provide parity in programmatic examples by including both PowerShell and bash/curl (or Python) snippets.
Avoid implying that PowerShell is the only or primary automation method; highlight REST API usage as a first-class option.

Create pull request

Bias Types:

⚠️ windows_tools

Summary:

The documentation is largely platform-neutral, focusing on HTTP requests and OAuth 2.0 protocol details. However, there is a subtle Windows bias in the suggestion to use 'Microsoft PowerShell' as an example HTTP client for testing POST requests, without mentioning Linux or cross-platform alternatives such as curl or HTTPie. No PowerShell-specific scripts or Windows-only tools are shown, but the only tool recommendation is Windows-centric.

Recommendations:

When suggesting HTTP clients for testing, mention cross-platform tools such as 'curl' or 'HTTPie' alongside or before 'Microsoft PowerShell'. For example: 'If you're testing this POST HTTP request, you can use any HTTP client such as curl, HTTPie, or Microsoft PowerShell.'
If providing example command-line invocations, include both Windows (PowerShell) and Linux/macOS (bash/curl) examples where appropriate.
Ensure that any tool recommendations or example commands are either cross-platform or that platform-specific alternatives are provided in parity.

Create pull request

No problematic pages found in this scan. All pages appear to be Linux-friendly! 🐧