Publishing OntoCode to the VS Code Marketplace

OntoCode is on the VS Code Marketplace. This checklist is for maintainers publishing new versions.

Prerequisites

• Visual Studio Marketplace publisher account (ontocode publisher id in extension/package.json)
• Personal Access Token with Marketplace Manage scope
• vsce installed (npm i -g @vscode/vsce or use project devDependency)
• Multi-platform release VSIX built by release workflow on GitHub

Pre-publish checks

1. Version bumped in extension/package.json and root Cargo.toml workspace version
2. CHANGELOG.md on GitHub updated
3. extension/README.md on GitHub and docs/vscode-install.md mention Marketplace install and current version
4. User docs synced per releasing.md checklist
5. npm test and cargo test --workspace pass
6. Screenshot or preview image in README (see docs/media/explorer-preview.png)

Publish command

cd extension
npm ci && npm run compile
npx vsce publish --no-dependencies

For a one-off VSIX without publishing:

npx vsce package --no-dependencies

After publish

1. Update root README Choose your path → VS Code to link Marketplace listing first, VSIX as fallback
2. Add Marketplace badge to README
3. Tag release and attach VSIX for users who prefer offline install

Token handling

Store VSCE_PAT or AZURE_DEVOPS_EXT_PAT in CI secrets only; never commit tokens.