Skip to content

Commit 7c8923f

Browse files
committed
Clarified prefix format: underscore and upper case should not be allowed; Changed reverse domain name notation to forward domain name notation.
1 parent 0361f62 commit 7c8923f

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

spec.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -471,13 +471,13 @@ message GetPluginInfoRequest {
471471
}
472472
473473
message GetPluginInfoResponse {
474-
// The name MUST follow reverse domain name notation format
475-
// (https://en.wikipedia.org/wiki/Reverse_domain_name_notation).
476-
// It SHOULD include the plugin's host company name and the plugin
477-
// name, to minimize the possibility of collisions. It MUST be 63
474+
// The name MUST follow domain name notation format
475+
// (https://tools.ietf.org/html/rfc1035#section-2.3.1). It SHOULD
476+
// include the plugin's host company name and the plugin name,
477+
// to minimize the possibility of collisions. It MUST be 63
478478
// characters or less, beginning and ending with an alphanumeric
479-
// character ([a-z0-9A-Z]) with dashes (-), underscores (_),
480-
// dots (.), and alphanumerics between. This field is REQUIRED.
479+
// character ([a-z0-9A-Z]) with dashes (-), dots (.), and
480+
// alphanumerics between. This field is REQUIRED.
481481
string name = 1;
482482
483483
// This field is REQUIRED. Value of this field is opaque to the CO.
@@ -975,12 +975,15 @@ message TopologyRequirement {
975975
// Valid keys have two segments: an optional prefix and name, separated
976976
// by a slash (/), for example: "com.company.example/zone".
977977
// The key name segment is required. The prefix is optional.
978-
// Both the key name and the prefix MUST each be 63 characters or less,
979-
// begin and end with an alphanumeric character ([a-z0-9A-Z]) and
980-
// contain only dashes (-), underscores (_), dots (.), or alphanumerics
981-
// in between, for example "zone".
982-
// The key prefix MUST follow reverse domain name notation format
983-
// (https://en.wikipedia.org/wiki/Reverse_domain_name_notation).
978+
// The key name MUST be 63 characters or less, begin and end with an
979+
// alphanumeric character ([a-z0-9A-Z]), and contain only dashes (-),
980+
// underscores (_), dots (.), or alphanumerics in between, for example
981+
// "zone".
982+
// The key prefix MUST be 63 characters or less, begin and end with a
983+
// lower-case alphanumeric character ([a-z0-9]), contain only
984+
// dashes (-), dots (.), or lower-case alphanumerics in between, and
985+
// follow domain name notation format
986+
// (https://tools.ietf.org/html/rfc1035#section-2.3.1).
984987
// The key prefix SHOULD include the plugin's host company name and/or
985988
// the plugin name, to minimize the possibility of collisions with keys
986989
// from other plugins.

0 commit comments

Comments
 (0)