Skip to content

docs(vscode): update VS Code Extension page to reflect the deprecation of the previous version #4207

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
Jul 23, 2025

Conversation

gnbm
Copy link
Contributor

@gnbm gnbm commented Jul 21, 2025

  • Since the Ionic VS Code extension has been deprecated in favor of the WebNative.dev extension and is no longer maintained, we updated the documentation to point to the right information, aligning with Capacitor's documentation for consistency.

  • Fix an unresolved link to ionic-webview page

  • Adds support for Windows users to run docs locally

  • Tested locally - ✅

image

@gnbm gnbm requested a review from a team as a code owner July 21, 2025 23:40
@gnbm gnbm requested a review from brandyscarney July 21, 2025 23:40
Copy link

vercel bot commented Jul 21, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
ionic-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 23, 2025 7:38pm

@gnbm gnbm requested review from Copilot and removed request for brandyscarney July 21, 2025 23:48
Copilot

This comment was marked as outdated.

@piotr-cz
Copy link

Copilot is correct here: extension id is WebNative.webnative as listed here: https://marketplace.visualstudio.com/items?itemName=ionic.ionic

@gnbm gnbm changed the title docs(vscode): Update VS Code Extension page to reflect the deprecation of the previous version docs(vscode): update VS Code Extension page to reflect the deprecation of the previous version Jul 22, 2025
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@gnbm gnbm requested a review from Copilot July 22, 2025 22:25
Copilot

This comment was marked as outdated.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copilot

This comment was marked as outdated.

Copilot

This comment was marked as outdated.

@gnbm
Copy link
Contributor Author

gnbm commented Jul 22, 2025

Copilot is correct here: extension id is WebNative.webnative as listed here: https://marketplace.visualstudio.com/items?itemName=ionic.ionic

image

Copy link
Member

@ShaneK ShaneK left a comment

Choose a reason for hiding this comment

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

Looks good to me. FWIW I do think you should have accepted the change from the AI about the capitalization of WebNative because I don't think we should rely on the case insensitive fallback working and it's a very easy change to accept, but it's not worth holding up this fix over.

@gnbm gnbm requested a review from Copilot July 23, 2025 19:18
Copilot

This comment was marked as outdated.

@gnbm gnbm requested review from Copilot, ShaneK and brandyscarney July 23, 2025 19:34
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR updates the VS Code Extension documentation to reflect the deprecation of the official Ionic VS Code extension in favor of the community-maintained WebNative extension. The changes ensure consistency with Capacitor's documentation approach and include technical improvements for cross-platform development.

  • Updates VS Code extension page to point to WebNative extension instead of deprecated Ionic extension
  • Fixes broken links to ionic-webview documentation across multiple versions
  • Adds Windows compatibility support for local documentation development

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/intro/vscode-extension.md Complete rewrite to reference WebNative extension with install buttons and documentation links
scripts/release-notes.mjs Updates file path handling for better Windows compatibility using fileURLToPath and dirname
src/styles/custom.scss Adds CSS classes for install and docs buttons used on the VS Code extension page
docs/core-concepts/webview.md Fixes broken link to ionic-webview documentation
versioned_docs/version-v6/core-concepts/webview.md Fixes broken link to ionic-webview documentation
versioned_docs/version-v7/core-concepts/webview.md Fixes broken link to ionic-webview documentation
versioned_docs/version-v5/native/ionic-webview.md Adds reference link to Awesome Cordova Plugins documentation
cspell-wordlist.txt Adds "webnative" to spell checker dictionary

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Member

@brandyscarney brandyscarney left a comment

Choose a reason for hiding this comment

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

Looks good! 👍

@gnbm gnbm merged commit 9c06008 into main Jul 23, 2025
4 checks passed
@gnbm gnbm deleted the gm-change-vs-extension branch July 23, 2025 20:32
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.

4 participants