Document kubectl's behavior regarding initializers

[caesarxuchao]

• document the --include-uninitialized kubectl flag;
• if a specific kubectl subcommand include uninitialized objects;
• --all includes uninitialized objects by default.

cc @dixudx @ahmetb

[ahmetb]

Isn't kubectl the right place to document this? We have quite a few topics and a cheatsheet, but I don't think we comprehensively document such kubectl options in the articles on the docs site.

[dixudx]

At least we should update https://kubernetes.io/docs/user-guide/kubectl/.

[ahmetb]

Not sure how one does actually reach that page. I thought we removed those pages. (I can't find any docs pages linking to that URL, makes me think it's an orphan page.)

New docs are at https://kubernetes.io/docs/reference/ ("kubectl CLI"). There are pages like:

• https://kubernetes.io/docs/user-guide/kubectl-overview/ (manual)
• https://kubernetes.io/docs/user-guide/kubectl-cheatsheet/ (manual)
• https://kubernetes.io/docs/user-guide/kubectl/v1.7/ (autogenerated)

I recommend updating the first two.

[dixudx]

Add documentation in PR #5505. PTAL.

[dixudx]

This issue can be closed, since #5505 has already been merged.

[tengqm]

ping @caesarxuchao, this can be closed.

[dixudx]

/close