github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2025-07-29 22:46:12 +00:00
Code Issues Projects Releases Wiki Activity

Document that int32 and int64 must be used in external types

Browse Source
This commit is contained in:
Clayton Coleman 2015-12-20 14:36:34 -05:00
parent 7a8b9e64bd
commit a79dc07e07
1 changed files with 1 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/devel/api-conventions.md
View File

@ -256,6 +256,7 @@ This rule maintains the invariant that all JSON/YAML keys are fields in API obje
* Do not use unsigned integers, due to inconsistent support across languages and libraries. Just validate that the integer is non-negative if that's the case.
* Do not use enums. Use aliases for string instead (e.g., `NodeConditionType`).
* Look at similar fields in the API (e.g., ports, durations) and follow the conventions of existing fields.
* All public integer fields MUST use the Go `(u)int32` or Go `(u)int64` types, not `(u)int` (which is ambiguous depending on target platform). Internal types may use `(u)int`.
#### Constants