Jennifer88huang commented on a change in pull request #11146:
URL: https://github.com/apache/pulsar/pull/11146#discussion_r661081816



##########
File path: site2/docs/admin-api-brokers.md
##########
@@ -4,16 +4,26 @@ title: Managing Brokers
 sidebar_label: Brokers
 ---
 
+> **Important**

Review comment:
       I'm not suggesting adding a separate "overview" doc page, my concern is: 
if we add the same content so much times, we need to consider adding it once in 
somewhere (that users visit most frequently, for example the "overview" of this 
whole chapter), and reference it when needed in other places. It's easy to 
maintain and keep consistent for a long run. We don't need to refine the same 
content many times manually in the future.




-- 
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]


Reply via email to