github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2025-07-23 11:50:44 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #4495 from yujuhong/api_docs

Browse Source 
Add a brief description on how we handle defaults
This commit is contained in:
Brian Grant 2015-02-18 17:03:55 -08:00
commit cf6e990723
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/api-conventions.md
View File

@ -137,6 +137,18 @@ All compatible Kubernetes APIs MUST support "name idempotency" and respond with
TODO: name generation
Defaulting
----------
Default resource values are API version-specific, and they are applied during
the conversion from API-versioned declarative configuration to internal objects
representing the desired state (`Spec`) of the resource.
Incorporating the default values into the `Spec` ensures that `Spec` depicts the
full desired state so that it is easier for the system to determine how to
achieve the state, and for the user to know what to anticipate.
Concurrency Control and Consistency
-----------------------------------
<a name="#concurrency"></a>