[docs]: KubeOps CLI usage for auto-generation may require `dotnet kubeops`
Describe the missing piece of documentation
In the documentation here under "Build Customization" where it talks about installing the KubeOps.Cli tool, it shows dotnet tool install KubeOps.Cli.
This installs the tool as a local tool and, thus, requires you to run it with dotnet kubeops rather than the global tool way, just kubeops.
What that means is that the default location of the tool as set in KubeOps.Operator.targets is wrong (kubeops instead of dotnet kubeops) so following the instructions doesn't work out of the box.
I found that I could set <KubeOpsCli>dotnet kubeops</KubeOpsCli> in my .csproj to fix it, but the <KubeOpsCli> configuration option isn't documented on that "Build Customization" page, so that was challenging to trace down.
It might be good to:
- Update the
KubeOps.Operator.targetsto usedotnet kubeopsas the default value for where the CLI is. - Document
<KubeOpsCli>on the "Build Customization" page and include information about changing that in build troubleshooting.