gianm commented on code in PR #18540:
URL: https://github.com/apache/druid/pull/18540#discussion_r2426788931


##########
docs/development/extensions-core/k8s-jobs.md:
##########
@@ -316,6 +316,52 @@ Host: http://ROUTER_IP:ROUTER_PORT
 ```
 </details>
 
+### Experimental HTTP Client Config
+
+:::warning
+
+This configuration is experimental and subject to change. The Druid developer 
community intends on selecting a stable default HTTP client and configuration 
in the future, simplifying configuration and distribution packaging. This means 
that not all exposed HTTP clients and their configurations will be supported 
long term. If you opt in to using this experimental configuration, please 
provide feedback to the Druid developer community (Apache mailing list: 
`[email protected]`) on your experience to help guide our long term 
decisions.
+
+:::
+
+The extension uses [fabric8 
KubernetesClient](https://github.com/fabric8io/kubernetes-client) to 
communicate with the Kubernetes API server. This client creates an

Review Comment:
   Since this is area where there are problems and our understanding of them is 
evolving, I think it would be better to move most of this info to a GitHub 
issue and link it here. Name the GitHub issue something like "Determine best 
Kubernetes API client"  and put the known issues and their mitigations there. 
That way, as our understanding evolves, old versions' documentation doesn't 
grow too stale. The only info we need here is a brief preamble, pointer to the 
GitHub issue, and the table with the descriptions of the configuration options.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to