Skip to content

Change extension readme with deprecation message#2337

Open
tharindulak wants to merge 4 commits into
wso2:mainfrom
tharindulak:change-ext-read
Open

Change extension readme with deprecation message#2337
tharindulak wants to merge 4 commits into
wso2:mainfrom
tharindulak:change-ext-read

Conversation

@tharindulak

@tharindulak tharindulak commented Jun 8, 2026

Copy link
Copy Markdown
Member

Purpose

Change extension readme with deprecation message.

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.

UI Component Development

Specify the reason if following are not followed.

  • Added reusable UI components to the ui-toolkit. Follow the intructions when adding the componenent.
  • Use ui-toolkit components wherever possible. Run npm run storybook from the root directory to view current components.
  • Matches with the native VSCode look and feel.

Manage Icons

Specify the reason if following are not followed.

  • Added Icons to the font-wso2-vscode. Follow the instructions.

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

  • New Features

    • Extensions now show a deprecation notice on activation with an option to install the recommended "WSO2 Integrator" extension.
  • Documentation

    • README files updated: BI and WSO2 Platform now show deprecation notices; Hurl client README streamlined its introductory text.

Copilot AI review requested due to automatic review settings June 8, 2026 07:05
@tharindulak tharindulak requested review from gigara and hevayo as code owners June 8, 2026 07:05
@coderabbitai

coderabbitai Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: caf12a81-b5ac-4293-9c36-c927a8c4943e

📥 Commits

Reviewing files that changed from the base of the PR and between e54403e and ad4c8f7.

📒 Files selected for processing (1)
  • workspaces/wso2-platform/wso2-platform-extension/src/extension.ts
🚧 Files skipped from review as they are similar to previous changes (1)
  • workspaces/wso2-platform/wso2-platform-extension/src/extension.ts

📝 Walkthrough

Walkthrough

Adds deprecation banners to BI and WSO2 Platform READMEs, simplifies the Hurl Client README start, and shows a runtime deprecation prompt in the WSO2 Platform extension that can open the WSO2 Integrator marketplace and record dismissal.

Changes

Extension Deprecation Notices and Migration

Layer / File(s) Summary
BI Extension deprecation notice
workspaces/bi/bi-extension/README.md
README adds an "IMPORTANT" deprecation banner stating the BI extension is deprecated and directing users to install the WSO2 Integrator extension.
WSO2 Platform extension deprecation notice and activation warning
workspaces/wso2-platform/wso2-platform-extension/README.md, workspaces/wso2-platform/wso2-platform-extension/src/extension.ts
README adds an "IMPORTANT" deprecation banner. activate shows a deprecation warning dialog when not dismissed, opens the WSO2 Integrator marketplace URL on "Install WSO2 Integrator" (with error handling), and records dismissal in globalState.
Hurl Client README introduction simplification
workspaces/hurl-client/hurl-client-extension/README.md
README removes the previous introductory sentence and starts directly with the "Open, edit, and execute .hurl files…" usage statement.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

  • hevayo
  • gigara
  • chathuranga-jayanath-99

Poem

🐰 I hopped through README fields tonight,

Removed old lines and set things right,
A gentle banner points the way,
"Install Integrator" — bright new day,
Tiny changes, future light.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Description check ⚠️ Warning The PR description uses the template structure but leaves most sections unfilled with placeholder text. Critical sections like Goals, Approach, Release note, and Documentation contain only template instructions without actual content. Provide concrete details in Goals, Approach, Release note, and Documentation sections. Remove or properly complete checkbox items marked as done but unrelated to README changes. Clarify the deprecation messaging strategy and user migration path.
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Change extension readme with deprecation message' accurately describes the main changes: README files were updated with deprecation notices directing users to the WSO2 Integrator extension.
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.

✏️ 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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds deprecation messaging for the WSO2 Platform-related extensions, guiding users toward the WSO2 Integrator extension and cleaning up related README content.

Changes:

  • Show a deprecation warning on WSO2 Platform extension activation with a link/action to install WSO2 Integrator.
  • Add prominent deprecation banners to the WSO2 Platform and BI extension READMEs.
  • Remove an outdated WSO2 Integrator-related note from the Hurl Client README.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File Description
workspaces/wso2-platform/wso2-platform-extension/src/extension.ts Adds an activation-time deprecation warning with an install call-to-action.
workspaces/wso2-platform/wso2-platform-extension/README.md Adds a deprecation notice pointing users to WSO2 Integrator.
workspaces/hurl-client/hurl-client-extension/README.md Removes an outdated statement tying the extension to WSO2 Integrator.
workspaces/bi/bi-extension/README.md Adds a deprecation notice pointing users to WSO2 Integrator.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread workspaces/wso2-platform/wso2-platform-extension/src/extension.ts Outdated
Comment thread workspaces/wso2-platform/wso2-platform-extension/README.md
Comment thread workspaces/bi/bi-extension/README.md
Comment thread workspaces/wso2-platform/wso2-platform-extension/src/extension.ts Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 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 `@workspaces/wso2-platform/wso2-platform-extension/src/extension.ts`:
- Around line 55-64: The deprecation warning is shown on every activation;
update the activation logic in extension.ts to store a flag in the extension's
Memento (use the activation context's globalState or workspaceState) and only
show the window.showWarningMessage if that flag is not set; present two buttons
(e.g., "Install WSO2 Integrator" and "Don't show again") and if the user clicks
"Don't show again" set a persistent key (like "wso2.deprecationDismissed") so
subsequent activations skip the prompt, and if they click the install button
open the marketplace URL as currently implemented.
- Line 62: The call to vscode.env.openExternal(vscode.Uri.parse(...)) can fail
or return false; update the call site to await the Thenable<boolean> from
vscode.env.openExternal and add error handling: wrap the await in a try/catch to
catch exceptions from malformed URIs or permission errors, check the returned
boolean and handle a false result, and report failures via
vscode.window.showErrorMessage and/or console.error so failures are surfaced;
look for the invocation of vscode.env.openExternal and vscode.Uri.parse in
extension.ts and replace the fire-and-forget call with an awaited call plus
try/catch and a false-result branch.
🪄 Autofix (Beta)

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: CHILL

Plan: Pro

Run ID: 31ecfa11-d6fc-414f-b2f0-d5597777eaed

📥 Commits

Reviewing files that changed from the base of the PR and between 1122a43 and e54403e.

📒 Files selected for processing (4)
  • workspaces/bi/bi-extension/README.md
  • workspaces/hurl-client/hurl-client-extension/README.md
  • workspaces/wso2-platform/wso2-platform-extension/README.md
  • workspaces/wso2-platform/wso2-platform-extension/src/extension.ts
💤 Files with no reviewable changes (1)
  • workspaces/hurl-client/hurl-client-extension/README.md

Comment thread workspaces/wso2-platform/wso2-platform-extension/src/extension.ts Outdated
Comment thread workspaces/wso2-platform/wso2-platform-extension/src/extension.ts Outdated
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