Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions protobuf/flagd/sync/v1/sync.proto
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ message SyncFlagsRequest {
// flag configurations from a collection, select the source of the flag or combine this to any desired underlying
// filtering mechanism.
// ex:- selector: 'source=database,app=weatherapp'
string selector = 2;
string selector = 2 [deprecated = true]; // remember to reserve field number 2 if this is removed;

Choose a reason for hiding this comment

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

medium

The comment explaining the deprecation could be more helpful to users of this API. It's good practice to mention what should be used as a replacement. The information about reserving the field is a good implementation detail for maintainers, but guiding users is more important for a deprecation message.

Suggested change
string selector = 2 [deprecated = true]; // remember to reserve field number 2 if this is removed;
string selector = 2 [deprecated = true]; // Deprecated: Use the 'Flagd-Selector' header instead.

}

// SyncFlagsResponse is the server response containing feature flag configurations and the state
Expand All @@ -54,7 +54,7 @@ message FetchAllFlagsRequest {
// flag configurations from a collection, select the source of the flag or combine this to any desired underlying
// filtering mechanism.
// ex:- selector: 'source=database,app=weatherapp'
string selector = 2;
string selector = 2 [deprecated = true]; // remember to reserve field number 2 if this is removed;

Choose a reason for hiding this comment

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

medium

The comment explaining the deprecation could be more helpful to users of this API. It's good practice to mention what should be used as a replacement. The information about reserving the field is a good implementation detail for maintainers, but guiding users is more important for a deprecation message.

Suggested change
string selector = 2 [deprecated = true]; // remember to reserve field number 2 if this is removed;
string selector = 2 [deprecated = true]; // Deprecated: Use the 'Flagd-Selector' header instead.

}

// FetchAllFlagsResponse is the server response containing feature flag configurations
Expand Down
Loading