Contradicting kubectl apply documentation #896
Labels
area/kubectl
kind/bug
Categorizes issue or PR as related to a bug.
sig/cli
Categorizes an issue or PR as relevant to SIG CLI.
Originally filed at: kubernetes/website#22465 (now closed)
Contradicting kubectl apply documentation
Problem:
The
kubectl apply
documentation here:https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply
Says that the
-k
flag should be used for a directory.However the documentation here for the kubectl overview:
https://kubernetes.io/docs/concepts/configuration/overview/#using-kubectl
Suggests using the
-f
flag for a directory. Why is there a discrepancy?Proposed Solution:
Clarification is needed that
-f
can take a file, a manifest URL, or a local directory containing manifests. If there are any particular reasons why-f
is best practice, these should be stated.Pages to Update:
One of the following pages should be updated or clarified:
https://kubernetes.io/docs/reference/generated/kubectl/kubectl-commands#apply
or
https://kubernetes.io/docs/concepts/configuration/overview/#using-kubectl
The text was updated successfully, but these errors were encountered: