Commit Graph

29 Commits (47ab49eb4f78de3abba31d6e4c8e2ae881d570f7)

Author SHA1 Message Date
Michelle Noorali bc8f7e2c59 replace contents of docs/devel with stubs 2016-12-21 20:26:48 -05:00
Brandon Philips 9216057589 kubectl: add less verbose version
The kubectl version output is very complex and makes it hard for users
and vendors to give actionable information. For example during the
recent Kubernetes 1.4.3 TLS security scramble I had to write a one-liner
for users to get out the version number to give to figure out if they
are vulnerable:

    $ kubectl version | grep -i Server | sed  -n 's%.*GitVersion:"\([^"]*\).*%\1%p'

Instead this patch outputs simply output with `--short`

    ./kubectl version --short
    Client Version: v1.4.3
    Server Version: v1.4.3
2016-11-10 14:07:42 -08:00
Tim Hockin b0fa2056a6 Remove 'this is HEAD' warning on docs 2016-10-26 00:06:59 +02:00
Fabiano Franz 0fd5c8d797 Use our own normalizers in the conventions doc 2016-10-17 11:50:02 -02:00
Davanum Srinivas e1373cf516 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

Update the devel/kubectl-conventions.md with the rules mentioned by
a few folks on which resources could be added to the special 'all' alias
2016-09-19 13:01:59 -04:00
David McMahon 385fb81407 Update the latestReleaseBranch to release-1.4 in the munger. 2016-09-01 14:40:55 -07:00
Silas Boyd-Wickizer 39a9ec3a4f Add a short `-n` for `kubectl`'s `--namespace`
fixes #24078

--namespace is a very common flag for nearly every kubectl command we have.
We should claim -n for it.
2016-08-16 08:32:47 -07:00
Daniel Smith b712bfd7ac Revert "Extend all to more resources" 2016-08-01 21:51:57 -07:00
Davanum Srinivas ccf4e4d61e 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

Update the devel/kubectl-conventions.md with the rules mentioned by
a few folks on which resources could be added to the special 'all' alias

Related to a suggestion in issue #22337
2016-07-24 21:14:50 -04:00
joe2far 88b6d4ad36 Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
joe2far 25b4341dc7 Make kubectl help strings consistent 2016-06-29 12:50:24 +01:00
Michael Rubin 37f9647dfe Document usage of dedent for kubectl commands 2016-06-26 22:51:16 -07:00
David McMahon 2bff72b769 Updated docs and examples for release-1.3. 2016-06-13 12:24:34 -07:00
Dawn Chen 88de86fcb9 Revert "Versioning docs and examples for v1.4.0-alpha.0."
This reverts commit cce9db3aa9.
2016-06-10 16:46:46 -07:00
David McMahon cce9db3aa9 Versioning docs and examples for v1.4.0-alpha.0. 2016-06-10 14:55:35 -07:00
Klaus Ma f3556be51d Update kubectl service output. 2016-05-14 11:10:29 +08:00
Mike Brown 0054ddcad1 devel/ tree 80col updates; and other minor edits
Signed-off-by: Mike Brown <brownwm@us.ibm.com>
2016-05-09 18:39:56 -05:00
k8s-merge-robot ff339c77cf Merge pull request #25269 from janetkuo/kubectl-conventions
Automatic merge from submit-queue

Document that kubectl commands shouldn't have aliases

## Pull Request Guidelines

1. Please read our [contributor guidelines](https://github.com/kubernetes/kubernetes/blob/master/CONTRIBUTING.md).
1. See our [developer guide](https://github.com/kubernetes/kubernetes/blob/master/docs/devel/development.md).
1. Follow the instructions for [labeling and writing a release note for this PR](https://github.com/kubernetes/kubernetes/blob/master/docs/devel/pull-requests.md#release-notes) in the block below.

```release-note
* Use the release-note-* labels to set the release note state 
* Clear this block to use the PR title as the release note 
-OR-
* Enter your extended release note here
```

Ref https://github.com/kubernetes/kubernetes/issues/25180#issuecomment-217453402 @kubernetes/kubectl 

[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/.github/PULL_REQUEST_TEMPLATE.md?pixel)]()
2016-05-09 15:03:19 -07:00
Janet Kuo b5ccc1465d Document that kubectl commands shouldn't have aliases 2016-05-09 11:19:52 -07:00
deads2k 8e8e9cdce0 create command guidance 2016-05-09 08:14:48 -04:00
David McMahon dae84f5306 Update the latestReleaseBranch to release-1.2 in the munger. 2016-03-08 18:59:28 -08:00
Maciej Szulik 178f8310f6 Updated kubectl convetions with information about describing empty fields 2016-03-07 13:31:19 +01:00
Michail Kargakis 426ef93358 docs: kubectl command structure and generators conventions 2016-01-31 17:24:17 +01:00
Janet Kuo fa25e29cbf Update kubectl convention about title column 2016-01-28 20:11:59 -08:00
Chao Xu 2b2f285777 run hack/update-generated-docs.sh 2015-12-21 10:41:30 -08:00
Tim Hockin dab591b629 Run update-gendocs 2015-11-13 13:57:57 -08:00
Brian Grant 97e505849f Start on expanding code expectations (aka "The bar") 2015-09-01 20:33:59 +00:00
Eric Paris 21d22e04be TYPO: fix documentation to point at update-generated-docs.sh 2015-08-14 18:50:03 -04:00
Brian Grant f04d721612 Update API conventions. Add kubectl conventions.
Ref #12322. Fixes #6797.
2015-08-14 01:32:38 +00:00