gmethvin commented on a change in pull request #11146: URL: https://github.com/apache/pulsar/pull/11146#discussion_r660430236
########## File path: site2/docs/admin-api-namespaces.md ########## @@ -905,7 +915,7 @@ admin.namespaces().removeDeduplicationSnapshotInterval(namespace) ### Namespace isolation -Coming soon. +You can use the Pulsar isolation policy to allocate resources (broker and bookie) for a namespace. For more information, see [here](administration-isolation.md). Review comment: I'd just linkify the term "Pulsar isolation policy" and remove the entire second sentence. ########## File path: site2/docs/admin-api-overview.md ########## @@ -9,15 +9,26 @@ The Pulsar admin interface enables you to manage all important entities in a Pul You can interact with the admin interface via: - HTTP calls, which are made against the admin {@inject: rest:REST:/} API provided by Pulsar brokers. For some RESTful APIs, they might be redirected to the owner brokers for serving with [`307 Temporary Redirect`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/307), hence the HTTP callers should handle `307 Temporary Redirect`. If you use `curl` commands, you should specify `-L` to handle redirections. + + > **Tip** Review comment: Why is this a "tip" and on the other page it's "important"? ########## File path: site2/docs/admin-api-brokers.md ########## @@ -4,16 +4,26 @@ title: Managing Brokers sidebar_label: Brokers --- +> **Important** +> +> This page only shows **some frequently used operations**. +> +> - For the latest and complete information about `pulsar-admin`, including commands, flags, descriptions, and more, see [here](http://pulsar.apache.org/tools/pulsar-admin/). +> +> - For the latest and complete information about `REST API`, including parameters, responses, samples, and more, see [here]{@inject: rest:REST:/}. Review comment: nit: no need for backticks here and on the below line, since we're not referring to a command. It can simply be "the REST API" and "the Java admin API". -- 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: commits-unsubscr...@pulsar.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org