Update API conventions

2018-06-12 10:01:03 +02:00 · 2018-06-12 10:01:03 +02:00 · 168901fc27
parent 2b07e541f8
commit 168901fc27
1 changed files with 3 additions and 0 deletions
--- a/contributors/devel/api-conventions.md
+++ b/contributors/devel/api-conventions.md
@ -755,6 +755,9 @@ must be specified as part of the value (e.g., `resource.Quantity`). Which
 approach is preferred is TBD, though currently we use the `fooSeconds`
 convention for durations.

+Duration fields must be represented as integer fields with units being
+part of the field name (e.g. `leaseDurationSeconds`). We don't use Duration
+in the API since that would require clients to implement go-compatible parsing.

 ## Selecting Fields