kubernetes
Documentation Update - installation procedure for kubectl on macOS
Proposing an update to the following doc/page: https://kubernetes.io/docs/tasks/tools/install-kubectl-macos/
Currently the page provides guidance using dated methods to install the binary
- Make the kubectl binary executable.
chmod +x ./kubectl
- Move the kubectl binary to a file location on your system PATH.
sudo mv ./kubectl /usr/local/bin/kubectl
===
This should be replaced by "install" - explicitly defining the owner and permissions
- Move the kubectl binary to /usr/local/bin using the
installcommand, while defining the owner and file permissionssudo install -o root -m 0755 ./kubectl /usr/local/bin/kubectl
This appears to be a significant undertaking as the same method is used in a large number of examples. (65 occurrences in 35 different documents)
geeko:website jradtke$ grep -r "mv ./kubectl" * | wc -l
65
geeko:website jradtke$ grep -r "mv ./kubectl" * | awk -F\: '{ print $1 }' | sort -u | wc -l
35
I am not sure what the best approach to updating would be: 1 big update to all docs - or 35 updates ;-)
This issue is currently awaiting triage.
SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.
The triage/accepted label can be added by org members by writing /triage accepted in a comment.
Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.
