[fix][doc] Optimize URLs for CLI tools page

[Anonymitaet]

This PR:

1. Removes metadata since it should not be shown on the Reference site

2. Removes broker-tool because [feat][doc] Separate CLI docs for doc gen automation #18051 (comment)

3. Update URLs to https://pulsar.apache.org/reference to make it more generic and easier to maintain

• doc

[Anonymitaet]

@SignorMercurio
could you please review this PR from a technical perspective? Thank you!

cc @tisonkun @momo-jun @DaveDuggins @D-2-Ed

[tisonkun]

I check the experience from:

• https://pulsar.apache.org/docs/next/reference-cli-bookkeeper/
• https://pulsar.apache.org/docs/next/reference-cli-tools/

All works correctly. Could you share a video to clarify the issue?

Screen.Recording.2022-10-19.at.13.11.46.mov

[SignorMercurio]

Why not use a single link instead of a list of CLI tool?

[Anonymitaet]

@SignorMercurio updated as you suggested, PTAL

[Anonymitaet]

@tisonkun

Update URLs to https://pulsar.apache.org/reference to make it more generic and easier to maintain

All commands in the green box are on the same page, so I set them all to https://pulsar.apache.org/reference (users can choose versions then) instead of individual links for lower maintenance costs and a temporary workaround for #18051 (comment)

[tisonkun]

OK...Although I think it changes several links if users save them in their bookmark previously.

Comments inline.

[tisonkun]

We don't move this README.md file to the site repo.

You can use https://github.com/apache/pulsar/blob/master/site2/README.md as a workaround, which I hope we can move into another doc page and update these links to the new page.

[Anonymitaet]

Sorry I don't fully understand this comment

Now the doc contribution guide overview is in site2/README.md, and [Pulsar Documentation Contribution Guide](../README.md) redirects users to the correct place.

[tisonkun]

It works on the GitHub repository but not for the Pulsar website. You can try to preview it and verify if you can jump to the README.md file.

[tisonkun]

Why do you make these chanes? If you'd like to set up redirections, I suggest:

````mdx-code-block
import {Redirect} from '@docusaurus/router';

<Redirect to="/reference" />
````

[Anonymitaet]

@SignorMercurio can I use this? Does it work?

[SignorMercurio]

No, the aim is not redirecting. Actually, reference-cli-bookkeeper.md (and the below) will not be shown on pulsar.apache.org. Rather, it'll be shown only in pulsar.apache.org/reference. Therefore, the frontmatter is no longer useful as it only works for Docusaurus.

[tisonkun]

ditto

[tisonkun]

ditto

[Anonymitaet]

Hi @tisonkun @SignorMercurio I‘ve updated based on your comments:

• Remove reference-cli-bookkeeper.md and reference-cli-pulsar-daemon.md
• Update URL

PTAL and feel free to approve, thanks.

[tisonkun]

Generally looks good. I suggest you leave the removing and moving reference cli docs task to @SignorMercurio so that he can simultaneously handle the process.

Otherwise, site build can fail and it takes more effort to recover these files and copy to the pulsar-site repo.

That is, do not remove:

• reference-cli-bookkeeper.md
• reference-cli-broker-tool.md
• reference-cli-pulsar-daemon.md

in this pull request. I think @SignorMercurio will handle it later.

[Anonymitaet]

Generally looks good. I suggest you leave the removing and moving reference cli docs task to @SignorMercurio so that he can simultaneously handle the process.

Otherwise, site build can fail and it takes more effort to recover these files and copy to the pulsar-site repo.

That is, do not remove:

• reference-cli-bookkeeper.md
• reference-cli-broker-tool.md
• reference-cli-pulsar-daemon.md

in this pull request. I think @SignorMercurio will handle it later.

@tisonkun OK, I've updated this PR based on your comments, PTAL

[Anonymitaet]

Ping @momo-jun to review

[Anonymitaet]

ping @momo-jun