[GitHub] [pulsar] tisonkun commented on issue #19912: PIP-261: Restructure Getting Started section

["tisonkun (via GitHub)" <gi...@apache.org>]

tisonkun commented on issue #19912:
URL: https://github.com/apache/pulsar/issues/19912#issuecomment-1501458624

   Hi @asafm! Thanks for starting this thread.
   
   I reviewed this proposal in two aspects.
   
   ## Content
   
   For three journeys in the proposal, we have contents for two of them:
   
   * Getting started with CLI:
     * https://pulsar.apache.org/docs/2.11.x/getting-started-home/
   * Getting started for sample applications:
     * https://pulsar.apache.org/docs/2.11.x/how-to-landing/
   
   The closest pages for getting started with operations are under the "Administration" chapter https://pulsar.apache.org/docs/2.11.x/administration-zk-bk/, while we don't have a portal page or getting started page.
   
   ## Structure
   
   The "Get Started" chapter is located on the top of the sidebar, and it should be fine.
   
   The "Tutorial" chapter is somewhat hard to find, so we may set up some links or refactor the content and merge it into Get Started chapter.
   
   For reference, [grpc-java](https://grpc.io/docs/languages/java/quickstart/) has a Quickstart page to run the very simple demo and then a "Basic tutorial" page to talk about every basic concept.
   
   The operations getting started content needs to write and we may prepend it as the first item of "Administration" chapter.


-- 
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-unsubscribe@pulsar.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org