Skip to content

Conversation

@timostamm
Copy link
Member

@timostamm timostamm commented Jan 6, 2026

This PR updates our guidance for extension numbers for predefined rules.

Our current guidance is:

  • Range 1,000 to 99,999 is for public schemas.
  • Public schemas should be registered in the Protobuf Global Extension Registry.
  • 100,000 to max (536,870,911) is for private schemas.

The new guidance is:

  • Range 10,000 to 49,999 is for public schemas.
  • Public schemas should be registered in the Protovalidate Extension Registry.
  • Range 50,000 to 99,999 is for private schemas, leaning on the documentation for custom options.

Since no predefined rules have been added to the Protobuf Global Extension Registry, this is not a breaking change.

The Protovalidate Extension Registry is a simple file in docs/extensions.md, similar to the Protobuf Global Extension Registry (https://github.com/protocolbuffers/protobuf/blob/main/docs/options.md). It is specific to extensions for validate.proto, while the Protobuf Global Extension Registry is specific to extensions for descriptor.proto. Potentially, the Protovalidate Extension Registry can be converted to an extension declaration in the future.

@github-actions
Copy link

github-actions bot commented Jan 6, 2026

The latest Buf updates on your PR. Results from workflow Buf CI / buf (pull_request).

BuildFormatLintBreakingUpdated (UTC)
✅ passed✅ passed✅ passed✅ passedJan 7, 2026, 10:36 AM

@timostamm timostamm marked this pull request as ready for review January 6, 2026 17:15
@timostamm timostamm requested a review from srikrsna-buf January 6, 2026 17:15
Copy link
Contributor

@jrinehart-buf jrinehart-buf left a comment

Choose a reason for hiding this comment

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

Documentation look good to me; I added an "instructions-first" rearrangement and @timostamm has added uniqueness clarifications.

@timostamm timostamm merged commit f903e5c into main Jan 8, 2026
7 checks passed
@timostamm timostamm deleted the tstamm/Add-the-Protovalidate-Extension-Registry branch January 8, 2026 12:57
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