[Docs] Clarify node create
help text about cluster reference
#808
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What
An attempt to make it more clear that node create can be used for both k3d cluster names and external clusters by URL.
Why
When I first looked at k3d node create, I didn't realize the cluster argument was for more than a k3d created cluster. I tried a few things before I searched the issues and found #549 & the PR that fixed it, #734 It might save some users some time if this is more clear in the help & documentation. I initially thought of adding a new section it the guides for this, but I'm not sure how common the use-case is.
Implications
Since it's documentation only, it's unlikely to be a breaking changes. A potential caveat would be a tool inspecting & expecting exact strings from the help:
k3d node create -h
. Since that's typically a pretty naive implementation, it's unlikely to cause any real world issues.