summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authork8s-merge-robot <k8s.production.user@gmail.com>2016-08-01 10:07:01 -0700
committerGitHub <noreply@github.com>2016-08-01 10:07:01 -0700
commita230a6fa34c40047e01ce4644cb5f3db368aa093 (patch)
tree9b251ed18de8665ef8fd42aebdd04f6b5f7e9cfc
parent632bb9a6f20c2f01eaa2c554d4832d5f362982e4 (diff)
parent4783107ecf1bd66ba0674913fc7aaa7e75cab1ee (diff)
Merge pull request #28955 from dims/roadmap-extend-all
Automatic merge from submit-queue Extend all to more resources Added more things from the list here: https://github.com/kubernetes/kubernetes/blob/master/pkg/kubectl/cmd/cmd.go#L159 Note, did not add events as it did not seem useful to me. Since this is just a list of messages generated by the system. Related to a suggestion in issue #22337
-rw-r--r--kubectl-conventions.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/kubectl-conventions.md b/kubectl-conventions.md
index 8705d285..22593025 100644
--- a/kubectl-conventions.md
+++ b/kubectl-conventions.md
@@ -43,6 +43,7 @@ Updated: 8/27/2015
- [Principles](#principles)
- [Command conventions](#command-conventions)
- [Create commands](#create-commands)
+ - [Rules for extending special resource alias - "all"](#rules-for-extending-special-resource-alias---all)
- [Flag conventions](#flag-conventions)
- [Output conventions](#output-conventions)
- [Documentation conventions](#documentation-conventions)
@@ -118,6 +119,21 @@ creating tls secrets. You create these as separate commands to get distinct
flags and separate help that is tailored for the particular usage.
+### Rules for extending special resource alias - "all"
+
+Here are the rules to add a new resource to the `kubectl get all` output.
+
+* No cluster scoped resources
+
+* No namespace admin level resources (limits, quota, policy, authorization
+rules)
+
+* No resources that are potentially unrecoverable (secrets and pvc)
+
+* Resources that are considered "similar" to #3 should be grouped
+the same (configmaps)
+
+
## Flag conventions
* Flags are all lowercase, with words separated by hyphens