-
Notifications
You must be signed in to change notification settings - Fork 38
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Document fields in spec to indicate when these were added. #215
Conversation
e4b20f8
to
1e5f869
Compare
Signed-off-by: Ed Bartosh <[email protected]>
1e5f869
to
61fe2c4
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For cases where fields were added, would it make sense to specify the version closer to the field name itself. e.g.: Annotations
(string, OPTIONAL, v0.6.0)?
I'd leave it as it is. "Added in v.6.0" sounds more informative to me. |
Signed-off-by: Ed Bartosh <[email protected]>
ca319de
to
9c4f75c
Compare
@@ -19,6 +20,7 @@ type Spec struct { | |||
type Device struct { | |||
Name string `json:"name"` | |||
// Annotations add meta information per device. Note these are CDI-specific and do not affect container metadata. | |||
// Added in v0.6.0. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One thought that I had was whether we wanted to add golang field tags so that we could parse these programatically? This could be done as a follow-up though.
@@ -10,6 +10,7 @@ type Spec struct { | |||
Version string `json:"cdiVersion"` | |||
Kind string `json:"kind"` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we want to call out the allowed character change for the class in a docstring?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks good.
I was wondering whether we wanted to add the version added as a Go struct tag, but this can be done as a follow-up after we've discussed it with others.
partial fix for #206