protobuf-specs
protobuf-specs copied to clipboard
[RFC] Rehome `io.intoto` namespace under `dev.sigstore`?
This repository currently contains a copy of the in-toto envelope message definitions, tweaked slightly to influence code generation:
https://github.com/sigstore/protobuf-specs/blob/85dce20afb5e8ad9e170328abb7ff2e61b758958/protos/envelope.proto
These message definitions currently declare their package namespace as io.intoto
, which is consistent with the original definition in the DSSE spec repo:
https://github.com/secure-systems-lab/dsse/blob/master/envelope.proto
Based on the conversation in #86, IMO it may make sense to change the package namespace to dev.sigstore.intoto
or similar here:
- We've slightly modified the message definition (adding metadata to reflect different codegen namespaces)
- We've slightly modified the definition's documentation (clarifying it in a few places)
- Our copy is (nominally) independent in the sense that we're locked into it, and upstream changes won't be reflected by us without additional compatibility work.
On the other hand:
- I'm not sure this actually matters: aside from code generation, does anything really care about the
package
namespace definition? - Maybe it's unidiomatic to change the package namespace like this? I'm not familiar enough with the Protobuf ecosystem to know.
CC @znewman01 @bobcallaway @haydentherapper for opinions here.