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 <xiaba...@163.com> wrote: > +1, that's great. > > > Regards, > Baike Xia > > > > > > At 2022-10-20 11:49:32, "xiaoqing gao" <gaoxq...@gmail.com> wrote: > >+1, the new document is much better. > > > >gaoxiaoqing > > > > > >李鹏霖 <lipeng...@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<zjsar...@gmail.com> 在2022年10月20日(星期四) > 上午9:19写道： > >> > >> > >> > >> +1, the new document looks great > >> > >> > >> > On Oct 19, 2022, at 20:12, Xiang Yang <yx91...@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" < > gfurnst...@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 < > >> borokna...@cloudera.com> > >> >> wrote: > >> >> > >> >>> +1, thanks for bringing this up. > >> >>> > >> >>> - Zoltan > >> >>> > >> >>> On Wed, Oct 19, 2022 at 11:02 AM Tamás Máté < > >> tma...@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 > >> >>>> > >> >>> >
