apache / apache/pulsar

[Doc] admin api permissions does not include tenant administration

Open
#20,957 1 comment 0 reactions 0 assignees View on GitHub
doc-required Stale
Dominant language
Java
Stars
15.3k
Forks
3.8k
Avg merge
1d 14h
Merged PRs (30d)
160

Description

### Search before asking

- [X] I searched in the [issues](https://github.com/apache/pulsar/issues) and found nothing similar.

### What issue do you find in Pulsar docs?

[This](https://pulsar.apache.org/docs/next/admin-api-permissions/) piece of documentation does not include any reference to tenant administration (e.g. using the `pulsar-admin tenant update` command to update administrator roles). It seems like it should be included here.

### What is your suggestion?

It would be great to include references to the tenant administration directly in this documentation and to show examples of its usage.

### Any reference?

The tenants page has a reference to the update command which would be nice to include in this documentation as well. See [here](https://pulsar.apache.org/docs/3.0.x/admin-api-tenants/#update).

### Are you willing to submit a PR?

- [X] I'm willing to submit a PR!

Contributor guide

Open the contributing guide

Research direction

Start with the admin API permissions documentation linked in the issue, then compare it with the tenants page's update section. Add tenant administration references and usage examples for updating administrator roles with pulsar-admin tenant update. Done means the permissions documentation covers tenant administration and matches the existing tenants guidance.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.