[GitHub] [pulsar] momo-jun opened a new pull request, #18015: [refactor][doc] Improve the IA of the Kubernetes chapter and merge into the deployment chapter

[GitBox]

momo-jun opened a new pull request, #18015:
URL: https://github.com/apache/pulsar/pull/18015

   
   ### Motivation
   
   The [Kubernetes (Helm)](https://pulsar.apache.org/docs/helm-overview) 
chapter mainly talks about the deployment. There are many unnecessary Xrefs, 
for example, the 
[deployment](https://pulsar.apache.org/docs/next/deploy-kubernetes) topic only 
provides an Xref to the installation topic, and then links to the deployment 
using helm. In addition, many topics inside also have inappropriate content 
chunks, for example, the major content of the Install and Required Tools topics 
belong to the Prepare topic. 
   
   This PR is to re-sort the information and incorporate the content into the 
Deployment chapter with a lean structure. 
   
   The content mapping is as follows.
   <img width="536" alt="image" 
src="https://user-images.githubusercontent.com/60642177/195290358-c0a95c20-5c53-46a1-9da8-a0d9a5a2c3e5.png";>
   
   Ref: [Pre-discussion](https://github.com/apache/pulsar/discussions/17866).
   
   ### Modifications
   
   1. Relocate the K8S content to the Deployment chapter according to the above 
content mapping.
   2. Re-org the Overview/Prepare/Deploy/Upgrade topics.
   3. Map the content in the original Install/Tools topics into the 
Deploy/Prepare topics.
   4. Redirect the original Overview/Install/Tools topics to the new topics 
inside the Deployment chapter.
   5. Refresh the sidebar and internal reference links.
   6. Add a deprecation notice to the old "Get started with Kubernetes" topic.
   
   ### Verifying this change
   
   **Overview**
   <img width="1417" alt="image" 
src="https://user-images.githubusercontent.com/60642177/195291869-c7e9d29a-d642-4850-827d-0cf9fdf360aa.png";>
   
   
   **Prepare**
   <img width="1719" alt="image" 
src="https://user-images.githubusercontent.com/60642177/195291757-a771c366-5dc3-4fd4-bf1f-53891f7fb395.png";>
   
   
   **Deploy**
   <img width="1649" alt="image" 
src="https://user-images.githubusercontent.com/60642177/195291643-4ba6a259-e942-42d5-b4fe-ddaf67775459.png";>
   
   **Upgrade**
   <img width="1430" alt="image" 
src="https://user-images.githubusercontent.com/60642177/195291982-626fc0aa-1c65-4b9f-8777-2c89522036bb.png";>
   
   
   ### Documentation
   
   - [x] `doc` <!-- Your PR contains doc changes. Please attach the local 
preview screenshots (run `sh start.sh` at `pulsar/site2/website`) to your PR 
description, or else your PR might not get merged. -->
   - [ ] `doc-required` <!-- Your PR changes impact docs and you will update 
later -->
   - [ ] `doc-not-needed` <!-- Your PR changes do not impact docs -->
   - [ ] `doc-complete` <!-- Docs have been already added -->
   
   


-- 
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