Skip to content

Fix typos, formatting and clarity issues in Quick Start Guide#10945

Open
SadevSaranga wants to merge 2 commits intowso2:masterfrom
SadevSaranga:master
Open

Fix typos, formatting and clarity issues in Quick Start Guide#10945
SadevSaranga wants to merge 2 commits intowso2:masterfrom
SadevSaranga:master

Conversation

@SadevSaranga
Copy link
Copy Markdown

@SadevSaranga SadevSaranga commented Mar 18, 2026

Purpose

Describe the problems, issues, or needs driving this feature/fix and include links to related issues in the following format: Resolves issue1, issue2, etc.

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.

Summary by CodeRabbit

  • Documentation
    • Enhanced the API Manager Quick Start Guide with improved clarity and terminology consistency.
    • Refined formatting and step-by-step instructions for better readability.
    • Updated labels and descriptive phrases to clarify guidance on procedures and URL handling.

Improved the Quick Start Guide by fixing minor grammar, formatting, and clarity issues. Added the missing word “the” before “WSO2 API Manager,” corrected the bullet list under the download step, and changed “zip” to uppercase “ZIP.” Explained <API-M_HOME> for beginners, added quotes around UI buttons like “Sign In” and “Try It Out,” and fixed minor punctuation and repeated phrases. Clarified instructions in Step 3 so users can easily reach the API Console.

These changes make the guide easier to read and follow for new users.
@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 18, 2026

Walkthrough

Documentation refinements to the API Manager quick-start guide, including terminology normalization (standardizing "WSO2 API-M" to "WSO2 API Manager"), formatting adjustments, button label updates, URL placeholder substitutions, and step clarifications without altering procedures or control flow.

Changes

Cohort / File(s) Summary
Documentation Updates
en/docs/get-started/api-manager-quick-start-guide.md
Editorial refinements including terminology normalization (WSO2 API-M → WSO2 API Manager), formatting/indentation adjustments, button label standardization (Try Out → TRY OUT), URL placeholders, and clarifying step descriptions without altering core procedures.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 Hops of joy through the words we refine,
WSO2 Manager shines in each line,
No logic is broken, no flow rearranged,
Just clarity wrapped in the wording we changed!

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description contains only the template structure with no actual content filled in to explain the changes, purpose, goals, or approach. Fill in the required template sections with specific details about what was fixed, why, and how the changes improve the documentation quality.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main changes: fixing typos, formatting, and clarity issues in the Quick Start Guide documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
📝 Coding Plan
  • Generate coding plan for human review comments

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 and usage tips.

Tip

CodeRabbit can use your project's `stylelint` configuration to improve the quality of CSS code reviews.

Add a Stylelint configuration file to your project to customize how CodeRabbit runs stylelint.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@en/docs/get-started/api-manager-quick-start-guide.md`:
- Line 79: In the sentence containing "URL.Copy" inside
en/docs/get-started/api-manager-quick-start-guide.md (the string "URL.Copy" is
the identifier), insert a space so it reads "URL. Copy" to separate the two
sentences; update that exact occurrence in the document.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 48f21aaf-f847-426e-bff0-6146291ea071

📥 Commits

Reviewing files that changed from the base of the PR and between ace872e and 4d20671.

📒 Files selected for processing (1)
  • en/docs/get-started/api-manager-quick-start-guide.md

| `HTTP Response Body` | `{"hello": "world"}` |

Finally click **Generate My HTTP Response** to save and generate the mock service url.
Finally, click **Generate My HTTP Response** to save and generate the mock service URL.Copy this URL as you will need it in step 5.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Missing space between sentences.

There's a missing space between "URL." and "Copy" in the sentence. It currently reads "URL.Copy" but should be "URL. Copy".

📝 Proposed fix
-    Finally, click **Generate My HTTP Response** to save and generate the mock service URL.Copy this URL as you will need it in step 5.
+    Finally, click **Generate My HTTP Response** to save and generate the mock service URL. Copy this URL as you will need it in step 5.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Finally, click **Generate My HTTP Response** to save and generate the mock service URL.Copy this URL as you will need it in step 5.
Finally, click **Generate My HTTP Response** to save and generate the mock service URL. Copy this URL as you will need it in step 5.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@en/docs/get-started/api-manager-quick-start-guide.md` at line 79, In the
sentence containing "URL.Copy" inside
en/docs/get-started/api-manager-quick-start-guide.md (the string "URL.Copy" is
the identifier), insert a space so it reads "URL. Copy" to separate the two
sentences; update that exact occurrence in the document.

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