Skip to content

Deprecate in favor of ms-dotnettools.msbuild-binlog-analyzer - #19

Merged
YuliiaKovalova merged 2 commits into
mainfrom
deprecate-in-favor-of-ms-dotnettools
Jul 24, 2026
Merged

Deprecate in favor of ms-dotnettools.msbuild-binlog-analyzer#19
YuliiaKovalova merged 2 commits into
mainfrom
deprecate-in-favor-of-ms-dotnettools

Conversation

@YuliiaKovalova

Copy link
Copy Markdown
Contributor

Summary

Converts this dotutils.binlog-analyzer build into a migration tombstone that moves users to the official Microsoft extension MSBuild Binlog Analyzer for VS Code (ms-dotnettools.msbuild-binlog-analyzer).

Changes

  • src/deprecationNotice.ts (new): best-effort, non-blocking prompt on activation. Offers Install new extension (installs ms-dotnettools.msbuild-binlog-analyzer), then optionally uninstall this one & reload. Stays silent if the official extension is already installed or the user chose "Don't show again".
  • src/extension.ts: invokes the notice early in activate().
  • package.json: displayName/description marked DEPRECATED pointing at the new id; version 0.10.27 → 0.10.28 so a final notice release can be published.
  • README.md: prominent deprecation banner. CHANGELOG.md: 0.10.28 entry.

Existing functionality is intentionally left intact so current users are not broken mid-migration.

Validation

  • npm run compile (tsc) passes clean.

Follow-ups (outside this repo)

  1. Publish the 0.10.28 tombstone to the Marketplace.
  2. Request the official "deprecated in favor of" migration entry via the VS Code Marketplace extension-control manifest (owned by the ms-dotnettools team).

ykovalova and others added 2 commits July 24, 2026 12:42
This dotutils extension has been superseded by the official Microsoft
extension "MSBuild Binlog Analyzer for VS Code"
(ms-dotnettools.msbuild-binlog-analyzer). Convert this build into a
migration tombstone that guides users to the replacement:

- activate(): best-effort, non-blocking deprecation prompt that offers to
  install the official extension and uninstall this one (skipped once the
  official extension is present or the user dismisses it).
- package.json: mark displayName/description as DEPRECATED pointing at the
  new id; bump 0.10.27 -> 0.10.28 so a final notice release can ship.
- README: prominent deprecation banner linking to the new Marketplace item.
- CHANGELOG: 0.10.28 deprecation entry.

Existing functionality is left intact so current users are not broken while
they migrate.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 270764ca-be14-46fc-a3b4-3361dd725c25
A single transient toast is too easy to dismiss, so most users would never
migrate. Replace it with two harder-to-miss layers (still best-effort, never
blocks activation):

- One-time blocking modal (tracked in globalState). Escape/Cancel only defers
  it to the next activation; it is never treated as a permanent dismissal.
- Persistent amber status-bar item ("Binlog Analyzer deprecated") that remains
  every session until the user migrates or opts out, and re-opens the migration
  prompt on click.

"Install new extension" installs ms-dotnettools.msbuild-binlog-analyzer, hides
the status bar, and offers to uninstall this build and reload. "Don't show
again" suppresses both layers. Everything goes silent once the official
extension is installed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 270764ca-be14-46fc-a3b4-3361dd725c25
@YuliiaKovalova
YuliiaKovalova merged commit 3c044c5 into main Jul 24, 2026
3 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