[GitHub] [pulsar-site] Anonymitaet opened a new pull request, #493: [improve][doc] Optimize Admin API > Features > Brokers

[via GitHub]

Anonymitaet opened a new pull request, #493:
URL: https://github.com/apache/pulsar-site/pull/493

   ## What issues does this PR solve?
   
   There are some issues in the current [Admin API > Features > 
Brokers](https://pulsar.apache.org/docs/next/admin-api-clusters/) doc. I’ve 
summarized them with the corresponding solutions below.
   
   Issues | Solutions
   -- | --
   Some docs are inaccurate and make users confused. | Correct the description.
   Some docs are redundant and scattered. | Consolidate and optimize the 
explanations.
   Some docs are wrongly placed. <br><br>For example, "Concept"-type docs are 
shown in Sub-features, while they should be located elsewhere in Pulsar docs. | 
Move and consolidate them to the correct place. <br><br>For example, move 
"Concept"-type docs to [Reference > 
Terminology](https://pulsar.apache.org/docs/next/reference-terminology/).
   Some operations are in chaotic order. | Categorize operations logically to 
match users' learning pace. <br><br>For example, classify operations based on 
the CRUD sequence.
   
   ## What doc changes does this PR introduce?
   
   ### ✅ High-level structure changes
   
   - 🍊Old structure
   <img width="1487" alt="image" 
src="https://user-images.githubusercontent.com/50226895/228141586-6faff471-33ad-41bc-92d1-32fbd3eb7e05.png";>
   
   - 🍊New structure
   <img width="1543" alt="image" 
src="https://user-images.githubusercontent.com/50226895/228141639-bc082fcc-554a-451c-84f3-760e420442cb.png";>
   
   =================
   
   - [x] `doc` 
   


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