Improve doc

client/client.go

@@ -58,7 +58,7 @@ func Make(token string, baseUrl string, debug bool, key, cert, cacert string, in
 
 	err := result.initKindFromApi()
 	if err != nil {
-		fmt.Fprintf(os.Stderr, "Cannot init kinds from api: %s\nLet's switch to default from ctl binary\n", err)
+		fmt.Fprintf(os.Stderr, "Cannot access the openapi: %s\nSince the CLI can't access the open API, the list of Kinds reflects the most recent ones available at the time of the CLI's release (and not the latest ones overall)\n", err)
 		result.kinds = schema.DefaultKind()
 	}
 

cmd/root.go

@@ -24,9 +24,9 @@ func apiClient() *client.Client {
 var rootCmd = &cobra.Command{
 	Use:   "conduktor",
 	Short: "Command line tools for conduktor",
-	Long: `You need to define the CDK_TOKEN and CDK_BASE_URL environment variables to use this tool.
-You can also use the CDK_KEY,CDK_CERT, CDK_CACERT to use a certificate for tls authentication.
-If you have an untrusted certificate you can use the CDK_INSECURE=true variable to disable tls verification or set CDK_CACERT`,
+	Long: `Make sure you've set the environment variables CDK_TOKEN (generated from Console) and CDK_BASE_URL.
+Additionally, you can configure client TLS authentication by providing your certificate paths in CDK_KEY and CDK_CERT.
+For the server TLS authentication, you can either not check the certificate by setting CDK_INSECURE=true, or provide your own certificate authority using CDK_CACERT.`,
 	PersistentPreRun: func(cmd *cobra.Command, args []string) {
 		if *debug {
 			apiClient().ActivateDebug()