You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@pulsar.apache.org by Asaf Mesika <as...@gmail.com> on 2023/03/23 15:48:27 UTC
[DISCUSS] PIP-261: Restructure Getting Started section
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
Re: [DISCUSS] PIP-261: Restructure Getting Started section
Posted by Asaf Mesika <as...@gmail.com>.
So far I got 2 PMC members reviewing it. I'd appreciate it if one more
person could review it: https://github.com/apache/pulsar/issues/19912
Thanks!
On Mon, Apr 24, 2023 at 5:16 PM Asaf Mesika <as...@gmail.com> wrote:
> I've updated the PIP based on all comments made directly in the GitHub
> issue.
>
> Please take a look.
>
> Thanks!
>
> On Thu, Mar 30, 2023 at 7:39 AM Yu <li...@apache.org> wrote:
>
>> 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 <as...@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 <as...@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
>> > >
>> > >
>> >
>> >
>>
>
Re: [DISCUSS] PIP-261: Restructure Getting Started section
Posted by Asaf Mesika <as...@gmail.com>.
I've updated the PIP based on all comments made directly in the GitHub
issue.
Please take a look.
Thanks!
On Thu, Mar 30, 2023 at 7:39 AM Yu <li...@apache.org> wrote:
> 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 <as...@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 <as...@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
> > >
> > >
> >
> >
>
Re: [DISCUSS] PIP-261: Restructure Getting Started section
Posted by Yu <li...@apache.org>.
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 <as...@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 <as...@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
> >
> >
>
>
Re: [DISCUSS] PIP-261: Restructure Getting Started section
Posted by Asaf Mesika <as...@gmail.com>.
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 <as...@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
>
>