Hi Asaf,

Thanks for your great initiative!

To make the learning path accurate for all roles (beginners, developers,
operators) and give them what they need in minimal viable docs, I would
suggest making changes to information architecture, like creating 3 guides
(subpages of https://pulsar.apache.org/docs) for 3 roles respectively.

I've explained in detail with examples here [1], PTAL. Thank you!

[1] https://github.com/apache/pulsar/issues/19912#issuecomment-1489677523

On Thu, Mar 30, 2023 at 1:04 AM Asaf Mesika <asaf.mes...@gmail.com> wrote:

> I have only one reviewer so far.
> Would appreciate 2 more PMC members eyes on this.
>
> Thanks!
>
> Asaf
>
> > On 23 Mar 2023, at 17:48, Asaf Mesika <asaf.mes...@gmail.com> wrote:
> >
> > Hi,
> >
> > In light of PIP-98, I would like to present sub-PIP to restructure the
> Getting Started Section.
> >
> > https://github.com/apache/pulsar/issues/19912
> >
> >
> > The goal of this PIP is to describe how we want the Table Of Contents of
> the Getting Started section to look like. Using the TOC we’ll be able to
> rebuild this section to make it very easy to get started with Pulsar.
> >
> >
> > Would love to get your feedback on it.
> >
> >
> > Thanks!
> >
> > Asaf
> >
> >
>
>

Reply via email to