Skip to content

Fix documentation word- API Manager best practices line 21. Previousl…#10984

Open
seshanib wants to merge 3 commits intowso2:masterfrom
seshanib:master
Open

Fix documentation word- API Manager best practices line 21. Previousl…#10984
seshanib wants to merge 3 commits intowso2:masterfrom
seshanib:master

Conversation

@seshanib
Copy link
Copy Markdown

@seshanib seshanib commented Mar 25, 2026

Commit 1 - Spelling mistake noted in the API Manager Best Practices. Fixed that and locally tested.

Commit 2 - Standardized punctuation in two FAQ responses in Marketplace Assistant for consistent style and readability.

Commit 3 - Code Rabbit detected a s component in the heading of Marketplace Assistant (probably something I mistakenly added when I did the changes for spelling and grammar) So fixed that.

…y = such a camera api, Now = such as camera api
@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 25, 2026

Walkthrough

Two documentation files received minor corrections: a stray leading s was removed from a top-level Markdown heading in the marketplace assistant guide, and a grammar fix changed "terms such a" to "terms such as" in the best practices reference.

Changes

Cohort / File(s) Summary
Documentation Typo & Grammar Fixes
en/docs/api-developer-portal/discover-apis/marketplace-assistant.md, en/docs/reference/wso2-api-manager-best-practices.md
Removed an extraneous leading s from a top-level Markdown heading; corrected "terms such a" → "terms such as" and added trailing punctuation to two FAQ responses.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

A rabbit hopped through docs with care,
Found a stray s floating there,
Nudged a heading back in place,
Taught "such a" its proper grace,
Now the pages smile with flair 🐇✨

🚥 Pre-merge checks | ✅ 1 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Title check ⚠️ Warning The title mentions fixing documentation in API Manager best practices, which matches one of the two files changed, but it is incomplete and truncated, failing to mention the marketplace assistant changes. Update the title to comprehensively cover all changes or focus on the primary change with a complete, non-truncated description.
Description check ⚠️ Warning The pull request description lacks required sections from the template including Purpose, Goals, Approach, Release notes, Documentation, and other mandatory sections. Provide a comprehensive description following the template with Purpose (linked issues), Goals, Approach, Release notes, and Documentation sections. For documentation fixes, specify affected docs and impact.
✅ Passed checks (1 passed)
Check name Status Explanation
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

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.

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/api-developer-portal/discover-apis/marketplace-assistant.md`:
- Line 1: Remove the extraneous leading "s" before the "#" in the heading line
"s# Marketplace Assistant Getting Started Guide" so it becomes a proper H1 ("#
Marketplace Assistant Getting Started Guide"); also confirm the PR includes the
intended typo fix ("such a camera api" → "such as camera api") in the correct
document (the referenced "API Manager Best Practices" file) and, if missing, add
that change to the appropriate file instead of marketplace-assistant.md.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 4e65726a-f9cc-4cee-a5d6-e562ee094368

📥 Commits

Reviewing files that changed from the base of the PR and between bcf383b and 10cfe57.

📒 Files selected for processing (2)
  • en/docs/api-developer-portal/discover-apis/marketplace-assistant.md
  • en/docs/reference/wso2-api-manager-best-practices.md

@@ -1,4 +1,4 @@
# Marketplace Assistant Getting Started Guide
s# Marketplace Assistant Getting Started Guide
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 | 🔴 Critical

Critical: Remove extraneous "s" character breaking markdown heading syntax.

The heading has an extraneous "s" before the "#" symbol, which breaks the markdown heading syntax. This will prevent the title from rendering correctly as an H1 heading.

Also note: The PR description mentions fixing "such a camera api" → "such as camera api" in an "API Manager Best Practices" document, but this file is marketplace-assistant.md and shows no such changes. Please verify that the correct files were included in this PR.

🐛 Proposed fix to restore correct heading syntax
-s# Marketplace Assistant Getting Started Guide
+# Marketplace Assistant Getting Started Guide
📝 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
s# Marketplace Assistant Getting Started Guide
# Marketplace Assistant Getting Started Guide
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@en/docs/api-developer-portal/discover-apis/marketplace-assistant.md` at line
1, Remove the extraneous leading "s" before the "#" in the heading line "s#
Marketplace Assistant Getting Started Guide" so it becomes a proper H1 ("#
Marketplace Assistant Getting Started Guide"); also confirm the PR includes the
intended typo fix ("such a camera api" → "such as camera api") in the correct
document (the referenced "API Manager Best Practices" file) and, if missing, add
that change to the appropriate file instead of marketplace-assistant.md.

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.

♻️ Duplicate comments (1)
en/docs/api-developer-portal/discover-apis/marketplace-assistant.md (1)

1-1: ⚠️ Potential issue | 🟠 Major

Fix malformed H1 heading token on Line 1.

s# ... will not render as the intended top-level heading. Please change it to # Marketplace Assistant Getting Started Guide.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@en/docs/api-developer-portal/discover-apis/marketplace-assistant.md` at line
1, Replace the malformed H1 token "s# Marketplace Assistant Getting Started
Guide" with a proper Markdown heading by changing it to "# Marketplace Assistant
Getting Started Guide"; locate the exact string "s# Marketplace Assistant
Getting Started Guide" in the document and update it to the correct H1 token so
the top-level heading renders correctly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@en/docs/api-developer-portal/discover-apis/marketplace-assistant.md`:
- Line 1: Replace the malformed H1 token "s# Marketplace Assistant Getting
Started Guide" with a proper Markdown heading by changing it to "# Marketplace
Assistant Getting Started Guide"; locate the exact string "s# Marketplace
Assistant Getting Started Guide" in the document and update it to the correct H1
token so the top-level heading renders correctly.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 57b5ad56-a60e-4996-a45a-4ab0d87453c8

📥 Commits

Reviewing files that changed from the base of the PR and between 10cfe57 and 8fe45ba.

📒 Files selected for processing (1)
  • en/docs/api-developer-portal/discover-apis/marketplace-assistant.md

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