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



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

Review comment:
       Are you suggesting putting it in a separate "overview" documentation 
page?
   
   That doesn't really solve the problem here, which is to make sure someone 
who lands on this page is aware that it's not a complete description of all 
endpoints.
   
   What if we just eliminate this page altogether and use the generated pages 
instead? I don't see why we need a separate "frequently used operations" page 
and another complete reference.




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