Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Remove a bad example for selector defaulting #5665

Merged
merged 1 commit into from
Sep 29, 2017

Conversation

tengqm
Copy link
Contributor

@tengqm tengqm commented Sep 28, 2017

In a rapidly changing world, a previously encouraged practice is now becoming invalid. We should at least stop advocating such practices in the docs.

Changes made: remove a bad example that depends on old behavior of selector defaulting.

xref: #5650


This change is Reviewable

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Sep 28, 2017
@k8sio-netlify-preview-bot
Copy link
Collaborator

k8sio-netlify-preview-bot commented Sep 28, 2017

Deploy preview ready!

Built with commit 13d2a98

https://deploy-preview-5665--kubernetes-io-master-staging.netlify.com

Copy link
Contributor

@chenopis chenopis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the sentence should be rewritten for clarity.

@@ -23,7 +23,7 @@ This is a living document. If you think of something that is not on this list bu

Note also that many `kubectl` commands can be called on a directory, so you can also call `kubectl create` on a directory of config files. See below for more details.

- Don't specify default values unnecessarily, in order to simplify and minimize configs, and to reduce error. For example, omit the selector and labels in a `ReplicationController` if you want them to be the same as the labels in its `podTemplate`, since those fields are populated from the `podTemplate` labels by default. See the [guestbook app's](https://github.com/kubernetes/examples/tree/{{page.githubbranch}}/guestbook/) .yaml files for some [examples](https://github.com/kubernetes/examples/tree/{{page.githubbranch}}/guestbook/frontend-deployment.yaml) of this.
- Don't specify default values unnecessarily, in order to simplify and minimize configs, and to reduce error.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggested edit: "Don't specify default values unnecessarily -- simple and minimal config files will reduce errors."

@chenopis chenopis merged commit d54507c into kubernetes:master Sep 29, 2017
@tengqm tengqm deleted the fix-config-overview branch October 23, 2017 02:15
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants