Skip to content

Update API Gateway 1.1.0 quickstart - #433

Merged
selectiveduplicate merged 2 commits into
wso2:mainfrom
selectiveduplicate:sakib-qsg-fix-1.1.0
Aug 11, 2026
Merged

Update API Gateway 1.1.0 quickstart#433
selectiveduplicate merged 2 commits into
wso2:mainfrom
selectiveduplicate:sakib-qsg-fix-1.1.0

Conversation

@selectiveduplicate

@selectiveduplicate selectiveduplicate commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Purpose

Please note the title.

Relates to #426 and previous PR that fixed 1.0.0 and 1.2.0 quickstarts.

Checklist

  • Verified that llms.txt (located at en/docs/llms.txt) is updated for AI readiness content.
  • Ensured meaningful alt text for images and that the information contained in an image also appears in text so the relevant info exists in the body of the document.
  • Added or updated frontmatter for the respective pages.

Goals

Describe the solutions that this feature/fix will introduce to resolve the problems described above

Approach

Describe how you are implementing the solutions. Include an animated GIF or screenshot if the change affects the UI (email documentation@wso2.com to review all UI text). Include a link to a Markdown file or Google doc if the feature write-up is too long to paste here.

User stories

Summary of user stories addressed by this change>

Release note

Brief description of the new feature or bug fix as it will appear in the release notes

Documentation

Link(s) to product documentation that addresses the changes of this PR. If no doc impact, enter “N/A” plus brief explanation of why there’s no doc impact

Training

Link to the PR for changes to the training content in https://github.com/wso2/WSO2-Training, if applicable

Certification

Type “Sent” when you have provided new/updated certification questions, plus four answers for each question (correct answer highlighted in bold), based on this change. Certification questions/answers should be sent to certification@wso2.com and NOT pasted in this PR. If there is no impact on certification exams, type “N/A” and explain why.

Marketing

Link to drafts of marketing content that will describe and promote this feature, including product page changes, technical articles, blog posts, videos, etc., if applicable

Automation tests

  • Unit tests

    Code coverage information

  • Integration tests

    Details about the test cases and coverage

Security checks

Samples

Provide high-level details about the samples related to this feature

Related PRs

List any other related PRs

Migrations (if applicable)

Describe migration steps and platforms on which migration has been tested

Test environment

List all JDK versions, operating systems, databases, and browser/versions on which this feature/fix was tested

Learning

Describe the research phase and any blog posts, patterns, libraries, or add-ons you used to solve the problem.

@coderabbitai

coderabbitai Bot commented Aug 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@selectiveduplicate, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 32 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 741cfd49-eb45-4ae8-9d21-9ff1496b383a

📥 Commits

Reviewing files that changed from the base of the PR and between d080839 and 2677f2c.

📒 Files selected for processing (3)
  • en/docs/api-gateway/1.0.0/quick-start-guide.md
  • en/docs/api-gateway/1.1.0/quick-start-guide.md
  • en/docs/api-gateway/1.2.0/quick-start-guide.md
📝 Walkthrough

Walkthrough

The 1.1.0 Gateway quick-start guide updates its date and reorganizes setup, API deployment, HTTP/HTTPS verification, port diagnostics, and shutdown instructions.

Changes

Gateway quick-start guide

Layer / File(s) Summary
Gateway setup and deployment
en/docs/api-gateway/1.1.0/quick-start-guide.md
The guide separates download, extraction, startup, health checking, and API deployment steps.
HTTP and HTTPS invocation
en/docs/api-gateway/1.1.0/quick-start-guide.md
The guide adds HTTP and HTTPS request examples and describes successful routing and port-conflict diagnostics.
Port inspection and shutdown
en/docs/api-gateway/1.1.0/quick-start-guide.md
The guide adds a Windows PowerShell port-inspection command and documents shutdown options with their data-preservation behavior.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

Suggested reviewers: arshardh

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description includes the purpose and checklist but leaves most required sections as template placeholders. Complete the required sections, especially goals, approach, release note, documentation, testing, security checks, and related impact details.
✅ Passed checks (4 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly identifies the API Gateway 1.1.0 quickstart update.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 8

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@en/docs/api-gateway/1.1.0/quick-start-guide.md`:
- Around line 56-60: Update the introductory sentence before the cd command to
use direct wording: “Change to the root directory of the Gateway distribution.”
Keep the command unchanged.
- Line 70: Update the “Verify that the Gateway Controller is healthy”
documentation text to use a single trailing colon instead of a duplicate colon.
- Around line 166-176: Replace the generic “Option 1” and “Option 2” headings in
the quick-start guide with descriptive headings that state the shutdown and data
behavior, such as “Stop the Gateway and keep data” and “Stop the Gateway and
remove data.”
- Around line 47-59: Remove the stale ${version} placeholder instruction near
the download and extraction commands, keeping the existing hardcoded 1.1.0 URL,
archive name, and directory path consistent.
- Around line 62-63: Update the changed sections of the quick-start guide to
follow WSO2 Markdown spacing: add blank lines around headings at Steps 2 and the
sections near lines 69, 78, 125, 166, and 175, add a blank line before the HTTPS
fenced code block, and remove trailing whitespace from the affected headings.
- Around line 44-54: Update the download and extraction procedure near the
distribution commands to support each listed platform: add platform-specific
Windows PowerShell, macOS, and Linux commands, or explicitly state the required
shell tools and provide an equivalent supported setup path for Windows. Keep the
existing versioned gateway URL and archive name consistent across all
instructions.
- Around line 134-137: Update the HTTPS self-signed certificate example to
explicitly state that the curl command using -k is only for localhost testing.
Add guidance that non-local HTTPS requests must omit -k and use --cacert with
the CA file or a trusted CA store.
- Around line 63-74: Update the Step 3 verification instructions after docker
compose up -d to wait for Gateway Controller readiness with a bounded retry loop
before issuing the health curl request. Stop retrying after a finite timeout and
preserve the existing health endpoint check once the service responds.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 49c7fdcc-721e-4492-8d8d-08e3c6cacc4e

📥 Commits

Reviewing files that changed from the base of the PR and between f19cefa and d080839.

📒 Files selected for processing (1)
  • en/docs/api-gateway/1.1.0/quick-start-guide.md

Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md Outdated
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md Outdated
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md
Comment thread en/docs/api-gateway/1.1.0/quick-start-guide.md Outdated
@selectiveduplicate
selectiveduplicate merged commit 0897b39 into wso2:main Aug 11, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants