wso2 / wso2/api-platform

Windows (PowerShell) Commands Missing in AI Gateway Setup Instructions

Open
#1,211 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Area/AIGateway Area/Management Aspect/UX Severity/Minor Type/Bug
Dominant language
Go
Stars
71
Forks
111
Avg merge
1d 14h
Merged PRs (30d)
110

Description

Please select the area the issue is related to

Area/Management (Management API or Management Portal UI), Area/AIGateway (AI Gateway runtime/control plane)

Please select the aspect the issue is related to

Aspect/UX (User experience, flows, usability, clarity)

Description

The current setup instructions for downloading and configuring AI Gateway v0.8.6 only provide Linux/macOS (bash) commands. These commands do not work in Windows PowerShell because:

curl in PowerShell is an alias for Invoke-WebRequest

-sLO flags are not supported

unzip is not available by default

cat << 'ENVFILE' (heredoc syntax) is not supported in PowerShell

This causes errors for Windows users attempting to follow the documentation.

Steps to Reproduce

Steps to Reproduce

  1. Navigate to AI Workspace
    https://ai-workspace.bijira.dev/

  2. Log in with valid credentials.

  3. From the organization selector, choose your organization

  4. Navigate to: Gateways

  5. Open the Quick Start tab.

  6. Follow the instructions in the Quick Start tab using a Windows laptop (PowerShell).

Severity Level of the Issue

Severity/Minor (Non-critical functionality. Can be fixed in future releases)

Environment Details (with versions)

Operating System: Windows 11

Shell: Windows PowerShell

Browser: Google Chrome (latest stable version)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in the AI Workspace Gateways Quick Start tab and review the existing AI Gateway v0.8.6 setup instructions. Add equivalent Windows PowerShell commands for downloading, extracting, and creating the environment file, then verify the instructions on Windows 11 PowerShell.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.