sijia-w commented on a change in pull request #13118: URL: https://github.com/apache/pulsar/pull/13118#discussion_r766086439
########## File path: site2/docs/admin-api-packages.md ########## @@ -4,77 +4,89 @@ title: Manage packages sidebar_label: Packages --- -> **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 [Pulsar admin doc](https://pulsar.apache.org/tools/pulsar-admin/) -> -> - For the latest and complete information about `REST API`, including parameters, responses, samples, and more, see {@inject: rest:REST:/} API doc. -> -> - For the latest and complete information about `Java admin API`, including classes, methods, descriptions, and more, see [Java admin API doc](https://pulsar.apache.org/api/admin/). - -Package management enables version management and simplifies the upgrade and rollback processes for Functions, Sinks, and Sources. When you use the same function, sink and source in different namespaces, you can upload them to a common package management system. - -## Package name - -A `package` is identified by five parts: `type`, `tenant`, `namespace`, `package name`, and `version`. - -| Part | Description | -|-------|-------------| -|`type` |The type of the package. The following types are supported: `function`, `sink` and `source`. | -| `name`|The fully qualified name of the package: `<tenant>/<namespace>/<package name>`.| -|`version`|The version of the package.| - -The following is a code sample. - -```java -class PackageName { - private final PackageType type; - private final String namespace; - private final String tenant; - private final String name; - private final String version; -} - -enum PackageType { - FUNCTION("function"), SINK("sink"), SOURCE("source"); -} +Package managers or package-management systems automatically manage packages in a consistent manner. These tools simplify the installation tasks, upgrade process, and deletion operations for users. A package is the minimal unit that a package manager deals with. In Pulsar, packages are organized at the tenant- and namespace-level to manage Pulsar Functions and Pulsar IO connectors (i.e., source and sink). Review comment: Here we should use 'the'. -- 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