Commit Graph

8 Commits

Author SHA1 Message Date
Clayton Coleman
8c7a8b4347 Clarify the difference between kinds and resources in the API
As we prepare to expose additional endpoints for pod status, cloning,
binding, and templating, we should clarify the terminology and
distinctions. Use pod status as an example of an alternative "resource"
that shares the same "kind" (schema) as pods.
2015-02-20 15:46:27 -05:00
Sam Ghods
046c11d5fd Update api-conventions.md to fix heading link 2015-02-18 18:31:37 -08:00
Yu-Ju Hong
299d894dbb Add a brief description on how we handle defaults 2015-02-17 13:08:38 -08:00
nikhiljindal
7cd243cf31 Adding links to http://kubernetes.io/third_party/swagger-ui/ in our docs 2015-02-03 12:21:16 -08:00
Parth Oberoi
a5d413b774 typo fixed
'r' removed from 'identifies'
2015-01-21 21:36:43 +05:30
Brian Grant
d5700eac35 Documentation improvements. Fixes #2004, #2115, #2171. 2014-11-17 21:32:44 +00:00
Sam Ghods
1bd117ba1e Formatting tweaks to docs/api-conventions.md 2014-11-05 20:49:16 -08:00
Clayton Coleman
c0247d92ce Proposal for v1beta3 API
* Separate metadata from objects
* Treat lists differently from resources
* Add UID and Annotations on Metadata
* Introduce BoundPod(s) as distinct from Pod to represent pods
  scheduled onto a host
* Use "spec" instead of "state" and "status" instead of "currentState"
  * Identify current status of objects consistently
  * Use "condition" as the string label for substatus
* All string constants should be PublicGoCapitalized
* Rename Minion -> Node
* Rename ServerOp -> Operation
* Remove ContainerManifest
* Add api-conventions.md document
* Replace PodTemplateSpec in ReplCtrl with ObjectReference
2014-09-29 12:10:36 -04:00