cmccabe commented on code in PR #11969:
URL: https://github.com/apache/kafka/pull/11969#discussion_r868763592


##########
core/src/main/scala/kafka/server/KafkaConfig.scala:
##########
@@ -725,7 +727,11 @@ object KafkaConfig {
 
   /************* Authorizer Configuration ***********/
   val AuthorizerClassNameDoc = s"The fully qualified name of a class that 
implements <code>${classOf[Authorizer].getName}</code>" +
-  " interface, which is used by the broker for authorization."
+    " interface, which is used by the broker for authorization."
+  val EarlyStartListenersDoc = "A comma-separated list of listener names which 
should be started before any non-early start listeners. " +

Review Comment:
   > nit: the first sentence is seems circular
   
   Hmm, I don't know -- "started before any non-early-start listeners" does 
seem to convey some information. Circular would be more like "early start 
listeners are early start listeners," right? :) Maybe I'm misunderstanding your 
point.
   
   > I think it would be helpful to mention the authorizer use case.
   
   The second sentence says "This is useful in cases where the startup process 
requires some listeners to be open before other listeners can be brought up" 
which I thought was stating the use-case... do you have an idea for improving 
it?
   
   > Also, can we say something about the default?
   
   Good idea. I added a bit about the default (of controller listeners) at the 
end.



-- 
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: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to