wso2 / wso2/api-platform

[Bug]: CLI doc is outdated for rest-api command

Open Beginner friendly
#1,834 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Area/Gateway Area/Management Aspect/API Aspect/Other Severity/Major 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/Gateway (Routing, API deployment in gateway etc.)

Please select the aspect the issue is related to

Aspect/API (API backends, definitions, contracts, interfaces, OpenAPI), Aspect/Other (Anything else which does not match above categories)

Description

Following is shown in cli doc https://github.com/wso2/api-platform/blob/main/docs/cli/reference.md

ap gateway api delete --id

However, with the latest CLI release, the supported syntax is:

ap gateway rest-api delete --id

Steps to Reproduce

n/a

Severity Level of the Issue

Severity/Major (Important functionality is broken. Should be prioritized. Doesn't need immediate attention)

Environment Details (with versions)

No response

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

Update docs/cli/reference.md where the gateway API delete syntax is documented. Compare that entry with the latest CLI's supported command, using the CLI help if available. Done means the documentation uses ap gateway rest-api delete --id <id> consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
88/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.