Anonymitaet commented on code in PR #487: URL: https://github.com/apache/pulsar-site/pull/487#discussion_r1152986928
########## 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: > a single one doesn't make too much sense but has the chance to confuse users. The parallel structure (Pulsar APIs and REST APIs) confuses users as well. If not embedding it to the "Pulsar APIs" topic, how about optimizing the left TOC as below? ``` # Reference ## Pulsar APIs ### REST APIs ## Terminology ## Pulsar CLI tools ## ... ``` -- 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]
