Skip to content

Improve extension discoverability and overview#642

Closed
SagaciousB wants to merge 1 commit into
mainfrom
sagaciousb/extension-metadata
Closed

Improve extension discoverability and overview#642
SagaciousB wants to merge 1 commit into
mainfrom
sagaciousb/extension-metadata

Conversation

@SagaciousB

Copy link
Copy Markdown

Why

The display name was just "Buf" and the description was generic ("Visual
Studio Code support for Buf"), so the listing undersold what the extension
does and was hard to find by the terms people actually use - Protobuf,
.proto, and Protovalidate.

What

  • Display name, description, and keywords now cover Protobuf, .proto, and
    Protovalidate/CEL - all capabilities the Buf language server provides today
    (Protovalidate/CEL hovers, completions, and go-to-definition shipped in buf
    v1.67.0+).
  • Rewrote the README intro to lead with the language-server capabilities, and
    added a Protovalidate/CEL feature entry.
  • Added Marketplace and Open VSX install links up top; sorted the reference
    links.

Metadata and docs only - no behavior change.

- Expand display name, description, and keywords to cover Protobuf, .proto, and Protovalidate
- Rewrite README intro and add a Protovalidate/CEL feature
- Add Marketplace and Open VSX install links; sort reference links
@CLAassistant

CLAassistant commented Jun 2, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@SagaciousB SagaciousB requested a review from doriable June 2, 2026 23:59
Comment thread package.json
Comment on lines +3 to +4
"displayName": "Buf - Protobuf (.proto) & Protovalidate",
"description": "Protocol Buffers (proto) language support powered by the Buf language server: lint and build diagnostics, format on save, go-to-definition, hover docs, IntelliSense, and Protovalidate (CEL) editing support.",

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would keep the title shorter

Suggested change
"displayName": "Buf - Protobuf (.proto) & Protovalidate",
"description": "Protocol Buffers (proto) language support powered by the Buf language server: lint and build diagnostics, format on save, go-to-definition, hover docs, IntelliSense, and Protovalidate (CEL) editing support.",
"displayName": "Buf - Protocol Buffers",
"description": "Protobuf language support powered by the Buf language server: lint and build diagnostics, format on save, go-to-definition, hover docs, IntelliSense, and Protovalidate (CEL) editing support.",

Comment thread README.md
The [VS Code Buf extension][vs-code-marketplace] helps you work with [Protocol Buffers][protobuf]
files in a much more intuitive way, adding semantic syntax highlighting, navigation, formatting,
documentation and diagnostic hovers, and integrations with [Buf][buf] commands.
[Buf][buf] is a [Protocol Buffers][protobuf] (Protobuf) extension for Visual Studio Code. More

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm not sure what the best way to clean up the language here is, but I think we should separate "Buf" from the extension -- this is an extension for working with Protobuf powered by tools provided by the Buf ecosystem (e.g. the LSP).

@thezachdrake

Copy link
Copy Markdown

Closing in favor of a different solution.

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.

5 participants