[GitHub] [pulsar-site] Anonymitaet opened a new pull request, #462: [feat][doc] Add *Get Started* for API (Java + REST) and CLI (pulsar-admin)

[via GitHub]

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

   
   ### ☘️ What content does this PR add/update?
   
   ✅ 1. Green parts are newly added content and independent topics. 
   
   1.1 High-level: information architecture
   
   <img width="1176" alt="image" 
src="https://user-images.githubusercontent.com/50226895/223970486-a4e382b3-c383-4625-a094-ce8fc674b1db.png";>
   
   1.2 Details: content change explanations
   
   1.2.1 [Admin API > Get started (Java + 
REST)](https://pulsar.apache.org/docs/next/admin-api-get-started/)
   <img width="1512" alt="image" 
src="https://user-images.githubusercontent.com/50226895/223979449-79762c91-9b25-4c99-9d94-58e01e547506.png";>
   
   1.2.2 [Reference > CLI > Get started 
(pulsar-admin)](https://pulsar.apache.org/docs/next/reference-cli-tools/)
   <img width="716" alt="image" 
src="https://user-images.githubusercontent.com/50226895/223979520-1057e163-e8b8-4d3a-b144-559db020885a.png";>
   
   ✅ 2. They are designed based on the following factors:
      
   - [Learning path of 
Dev/DevOps](https://docs.google.com/document/d/1NWmfDyIyUGzXOqX8V28AHyORF72lTFIvxlM6n86wAfU/edit?pli=1#bookmark=id.xgnk69nwtqi)
 made in the content strategy report - [PIP-256: Building Great Developer 
Experience with API 
Content](https://docs.google.com/document/d/1NWmfDyIyUGzXOqX8V28AHyORF72lTFIvxlM6n86wAfU/edit?pli=1#bookmark=id.xgnk69nwtqi).
      
   - Design philosophies of "Topic-Based Authoring" and "Every Page is Page 
One".
   
   ### ☘️ Why add/update this content?
   
   - Based on the [user behavior metrics collected from 
GA](https://docs.google.com/document/d/1H-wEEfut18M18dle6a4-2EWCnLOqyJ81RVYxkPkTXhk/edit),
 the Pulsar API doc is one of the top-viewed content. However, we have not 
explained Pulsar API systematically and logically. 
   
   - In current docs, we do not have a real "Get Started" for Pulsar admin 
APIs. 
   
   - This doc is a part of [Building Great Developer Experience with API 
Content](https://docs.google.com/document/d/1NWmfDyIyUGzXOqX8V28AHyORF72lTFIvxlM6n86wAfU/edit?pli=1#heading=h.r3dt8xy5x3a3).
 You can check all delivered docs 
[here](https://docs.google.com/document/d/1NWmfDyIyUGzXOqX8V28AHyORF72lTFIvxlM6n86wAfU/edit?pli=1#bookmark=id.ph987o2jj8nw).
 More [Pulsar API 
content](https://docs.google.com/document/d/1NWmfDyIyUGzXOqX8V28AHyORF72lTFIvxlM6n86wAfU/edit?pli=1#bookmark=id.h0fmcaa7oxzs)
 will be created in the future.
   
   ---
   
   cc @momo-jun @DaveDuggins @D-2-Ed
   
   - [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