momo-jun commented on code in PR #487:
URL: https://github.com/apache/pulsar-site/pull/487#discussion_r1152911226


##########
docs/pulsar-api-overview.md:
##########
@@ -1,22 +1,39 @@
 ---
 id: pulsar-api-overview
-title: Pulsar API
-sidebar_label: "Overview"
+title: Pulsar APIs
+sidebar_label: "Pulsar APIs"
 ---
 
 ````mdx-code-block
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ````
 
-Pulsar is a messaging and streaming platform that scales across organizations 
of all sizes. Pulsar APIs are the core building blocks of Pulsar, which allow 
you to interact with Pulsar or administer Pulsar clusters. Pulsar APIs consist 
of the following types:
+Pulsar is a messaging and streaming platform that scales across organizations 
of all sizes. 
 
-- [Pulsar client APIs](client-api-overview.md)
-
-- [Pulsar admin APIs](admin-api-overview.md)

Review Comment:
   It's a compromise. 
   1. The links are too close (to the following two targets) to redirect, 
especially for the admin API section (newly added heading2), which provides 
another link to the overview topic. It's just not a good idea to let users 
click twice for a single piece of information. So I select to keep the link 
under the heading2.
   2. Both the illustration and the following headings can help them get to 
this point.



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