You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@impala.apache.org by 李鹏霖 <li...@sensorsdata.cn> on 2022/10/20 04:31:54 UTC
回复： Re: [DISCUSS] Prettify Apache site docs
+1
Actually I prefer the old style, but the new style should be more acceptable to all users.
Regards,
LiPenglin
----------回复的邮件信息----------
Jian Zhang<zjsariel@gmail.com> 在2022年10月20日(星期四) 上午9:19写道：
+1, the new document looks great
> On Oct 19, 2022, at 20:12, Xiang Yang <yx91490@126.com> wrote:
>
> +1 for 'change the user facing documentation on the Apache site'.
>
>
>
>
> Regards,
> Xiang Yang
>
>
>
>
> At 2022-10-19 20:04:37,"Gergely Fürnstáhl" <gfurnstahl@cloudera.com>, said:
>> +1, great idea, I prefer using the HTML one over the PDF, this would make
>> the experience a lot better.
>>
>>
>> On Wed, Oct 19, 2022 at 12:35 PM Zoltán Borók-Nagy <boroknagyz@cloudera.com>
>> wrote:
>>
>>> +1, thanks for bringing this up.
>>>
>>> - Zoltan
>>>
>>> On Wed, Oct 19, 2022 at 11:02 AM Tamás Máté <tmater@apache.org> wrote:
>>>
>>>> Hi Team,
>>>>
>>>> we are having a few discussion threads lately, here is another one. :)
>>>>
>>>> We are releasing quite plain html docs on the Apache Impala site, which I
>>>> really like, but from user perspective I believe it is harder to digest.
>>> I
>>>> think adding a side navigation bar and some color would make it a bit
>>> more
>>>> accessible, so I played a bit with dita and dita's own doc template and
>>>> came up with this:
>>>>
>>> https://issues.apache.org/jira/secure/attachment/13051169/doc_style_v1.png
>>>> for comparison the current page:
>>>>
>>> https://impala.apache.org/docs/build/html/topics/impala_config_options.html
>>>> .
>>>>
>>>> We should keep the plain xhtml docs as well in case someone would like to
>>>> embed it. What I would like to propose is to change the user facing
>>>> documentation on the Apache site. What do you think?
>>>>
>>>> Best regards,
>>>> Tamas
>>>>
>>>
Re: [DISCUSS] Prettify Apache site docs
Posted by Tamás Máté <tm...@apache.org>.
Thanks everyone for the input. The base commit for the change can be found
here:
https://gerrit.cloudera.org/#/c/19242/
let me know your thoughts.
The docs can be built with:
---
cd docs
make asf-site-html
---
The result index.html should be: docs/build/asf-site-html/index.html
Also, I think it would be better to point the
https://impala.apache.org/impala-docs.html to
https://impala.apache.org/docs/build/html/topics/impala_intro.html instead
of index.html,
but this would be a deploying step.
On Thu, 20 Oct 2022 at 12:36, Baike Xia <xi...@163.com> wrote:
> +1, that's great.
>
>
> Regards,
> Baike Xia
>
>
>
>
>
> At 2022-10-20 11:49:32, "xiaoqing gao" <ga...@gmail.com> wrote:
> >+1, the new document is much better.
> >
> >gaoxiaoqing
> >
> >
> >李鹏霖 <li...@sensorsdata.cn> 于2022年10月20日周四 12:32写道：
> >
> >> +1
> >> Actually I prefer the old style, but the new style should be more
> >> acceptable to all users.
> >>
> >>
> >> Regards,
> >> LiPenglin
> >>
> >>
> >> ----------回复的邮件信息----------
> >> Jian Zhang<zjsariel@gmail.com> 在2022年10月20日(星期四)
> 上午9:19写道：
> >>
> >>
> >>
> >> +1, the new document looks great
> >>
> >>
> >> > On Oct 19, 2022, at 20:12, Xiang Yang <yx91490@126.com> wrote:
> >> >
> >> > +1 for 'change the user facing documentation on the Apache site'.
> >> >
> >> >
> >> >
> >> >
> >> > Regards,
> >> > Xiang Yang
> >> >
> >> >
> >> >
> >> >
> >> > At 2022-10-19 20:04:37,"Gergely Fürnstáhl" <
> gfurnstahl@cloudera.com>,
> >> said:
> >> >> +1, great idea, I prefer using the HTML one over the PDF, this
> >> would make
> >> >> the experience a lot better.
> >> >>
> >> >>
> >> >> On Wed, Oct 19, 2022 at 12:35 PM Zoltán Borók-Nagy <
> >> boroknagyz@cloudera.com>
> >> >> wrote:
> >> >>
> >> >>> +1, thanks for bringing this up.
> >> >>>
> >> >>> - Zoltan
> >> >>>
> >> >>> On Wed, Oct 19, 2022 at 11:02 AM Tamás Máté <
> >> tmater@apache.org> wrote:
> >> >>>
> >> >>>> Hi Team,
> >> >>>>
> >> >>>> we are having a few discussion threads lately, here is
> >> another one. :)
> >> >>>>
> >> >>>> We are releasing quite plain html docs on the Apache
> >> Impala site, which I
> >> >>>> really like, but from user perspective I believe it is
> >> harder to digest.
> >> >>> I
> >> >>>> think adding a side navigation bar and some color would
> >> make it a bit
> >> >>> more
> >> >>>> accessible, so I played a bit with dita and dita's own
> >> doc template and
> >> >>>> came up with this:
> >> >>>>
> >> >>>
> >>
> https://issues.apache.org/jira/secure/attachment/13051169/doc_style_v1.png
> >> >>>> for comparison the current page:
> >> >>>>
> >> >>>
> >>
> https://impala.apache.org/docs/build/html/topics/impala_config_options.html
> >> >>>> .
> >> >>>>
> >> >>>> We should keep the plain xhtml docs as well in case
> >> someone would like to
> >> >>>> embed it. What I would like to propose is to change the
> >> user facing
> >> >>>> documentation on the Apache site. What do you think?
> >> >>>>
> >> >>>> Best regards,
> >> >>>> Tamas
> >> >>>>
> >> >>>
>
Re: [DISCUSS] Prettify Apache site docs
Posted by Baike Xia <xi...@163.com>.
+1, that's great.
Regards,
Baike Xia
At 2022-10-20 11:49:32, "xiaoqing gao" <ga...@gmail.com> wrote:
>+1, the new document is much better.
>
>gaoxiaoqing
>
>
>李鹏霖 <li...@sensorsdata.cn> 于2022年10月20日周四 12:32写道：
>
>> +1
>> Actually I prefer the old style, but the new style should be more
>> acceptable to all users.
>>
>>
>> Regards,
>> LiPenglin
>>
>>
>> ----------回复的邮件信息----------
>> Jian Zhang<zjsariel@gmail.com> 在2022年10月20日(星期四) 上午9:19写道：
>>
>>
>>
>> +1, the new document looks great
>>
>>
>> > On Oct 19, 2022, at 20:12, Xiang Yang <yx91490@126.com> wrote:
>> >
>> > +1 for 'change the user facing documentation on the Apache site'.
>> >
>> >
>> >
>> >
>> > Regards,
>> > Xiang Yang
>> >
>> >
>> >
>> >
>> > At 2022-10-19 20:04:37,"Gergely Fürnstáhl" <gfurnstahl@cloudera.com>,
>> said:
>> >> +1, great idea, I prefer using the HTML one over the PDF, this
>> would make
>> >> the experience a lot better.
>> >>
>> >>
>> >> On Wed, Oct 19, 2022 at 12:35 PM Zoltán Borók-Nagy <
>> boroknagyz@cloudera.com>
>> >> wrote:
>> >>
>> >>> +1, thanks for bringing this up.
>> >>>
>> >>> - Zoltan
>> >>>
>> >>> On Wed, Oct 19, 2022 at 11:02 AM Tamás Máté <
>> tmater@apache.org> wrote:
>> >>>
>> >>>> Hi Team,
>> >>>>
>> >>>> we are having a few discussion threads lately, here is
>> another one. :)
>> >>>>
>> >>>> We are releasing quite plain html docs on the Apache
>> Impala site, which I
>> >>>> really like, but from user perspective I believe it is
>> harder to digest.
>> >>> I
>> >>>> think adding a side navigation bar and some color would
>> make it a bit
>> >>> more
>> >>>> accessible, so I played a bit with dita and dita's own
>> doc template and
>> >>>> came up with this:
>> >>>>
>> >>>
>> https://issues.apache.org/jira/secure/attachment/13051169/doc_style_v1.png
>> >>>> for comparison the current page:
>> >>>>
>> >>>
>> https://impala.apache.org/docs/build/html/topics/impala_config_options.html
>> >>>> .
>> >>>>
>> >>>> We should keep the plain xhtml docs as well in case
>> someone would like to
>> >>>> embed it. What I would like to propose is to change the
>> user facing
>> >>>> documentation on the Apache site. What do you think?
>> >>>>
>> >>>> Best regards,
>> >>>> Tamas
>> >>>>
>> >>>
Re: Re: [DISCUSS] Prettify Apache site docs
Posted by xiaoqing gao <ga...@gmail.com>.
+1, the new document is much better.
gaoxiaoqing
李鹏霖 <li...@sensorsdata.cn> 于2022年10月20日周四 12:32写道：
> +1
> Actually I prefer the old style, but the new style should be more
> acceptable to all users.
>
>
> Regards,
> LiPenglin
>
>
> ----------回复的邮件信息----------
> Jian Zhang<zjsariel@gmail.com> 在2022年10月20日(星期四) 上午9:19写道：
>
>
>
> +1, the new document looks great
>
>
> > On Oct 19, 2022, at 20:12, Xiang Yang <yx91490@126.com> wrote:
> >
> > +1 for 'change the user facing documentation on the Apache site'.
> >
> >
> >
> >
> > Regards,
> > Xiang Yang
> >
> >
> >
> >
> > At 2022-10-19 20:04:37,"Gergely Fürnstáhl" <gfurnstahl@cloudera.com>,
> said:
> >> +1, great idea, I prefer using the HTML one over the PDF, this
> would make
> >> the experience a lot better.
> >>
> >>
> >> On Wed, Oct 19, 2022 at 12:35 PM Zoltán Borók-Nagy <
> boroknagyz@cloudera.com>
> >> wrote:
> >>
> >>> +1, thanks for bringing this up.
> >>>
> >>> - Zoltan
> >>>
> >>> On Wed, Oct 19, 2022 at 11:02 AM Tamás Máté <
> tmater@apache.org> wrote:
> >>>
> >>>> Hi Team,
> >>>>
> >>>> we are having a few discussion threads lately, here is
> another one. :)
> >>>>
> >>>> We are releasing quite plain html docs on the Apache
> Impala site, which I
> >>>> really like, but from user perspective I believe it is
> harder to digest.
> >>> I
> >>>> think adding a side navigation bar and some color would
> make it a bit
> >>> more
> >>>> accessible, so I played a bit with dita and dita's own
> doc template and
> >>>> came up with this:
> >>>>
> >>>
> https://issues.apache.org/jira/secure/attachment/13051169/doc_style_v1.png
> >>>> for comparison the current page:
> >>>>
> >>>
> https://impala.apache.org/docs/build/html/topics/impala_config_options.html
> >>>> .
> >>>>
> >>>> We should keep the plain xhtml docs as well in case
> someone would like to
> >>>> embed it. What I would like to propose is to change the
> user facing
> >>>> documentation on the Apache site. What do you think?
> >>>>
> >>>> Best regards,
> >>>> Tamas
> >>>>
> >>>