Thanks Owen, Stamatis, Ayush and Alessandro for the feedback. - Regarding the javadocs and the automatically build and to deploy github-pages discussion in the previous PR thread [1] <https://github.com/apache/hive/pull/1410>,
- Apache Iceberg-docs ([2] <https://iceberg.apache.org/javadoc/latest/>) has recently set up a github workflow ([3]) <https://github.com/apache/iceberg-docs/actions/runs/3062679467/jobs/4943928455> to publish the javadocs from a given javadocs dir [4] <https://github.com/apache/iceberg-docs/tree/main/javadoc> , I think we can setup the same workflow for Hive javadocs. - As Ayush and Stamatis have mentioned, I think over the past 2 years, apache infra has added support for github actions and we can confirm that from Apache Iceberg/calcite docs that are currently using it. - But I am not sure regarding which branch or directory we will need to put the hive javadoc files . This needs more discussion and we can follow up on this([5] <https://github.com/apache/hive/pull/1410#issuecomment-680111530>) . - I am not aware about the procedure or the approvals we need to move from hive-site repo back to the main repository. We will need help with this. - I was able to setup the github action on the POC repo: https://github.com/simhadri-g/hive-site/tree/new-site . - Any changes to this repo/new-site will automatically reflect here once the github workflow completes: https://simhadri-g.github.io/hive-site/ . - Considering the feedback, I think we can plan to do in 3 phases, for the first cut I would like to update the website in the present setup, followed by moving the javadocs to the hive-site repo and as for the third phase , we can work on migrating from hive-site to hive repo. - If everyone agrees, can we please go ahead with the first phase? [1]https://github.com/apache/hive/pull/1410, [2]https://iceberg.apache.org/javadoc/latest/ [3] https://github.com/apache/iceberg-docs/actions/runs/3062679467/jobs/4943928455 [4]https://github.com/apache/iceberg-docs/tree/main/javadoc [5]https://github.com/apache/hive/pull/1410#issuecomment-680111530 [6] https://github.com/apache/hive/pull/1410#issuecomment-680102815 Thanks! Simhadri G On Mon, Sep 19, 2022 at 1:50 PM Alessandro Solimando < alessandro.solima...@gmail.com> wrote: > Hi everyone, > thanks Simhadri for pushing this forward. > > I like the look and feel of the new website, and I agree with Stamatis > that having the website sources in the Hive repo, and automatically > publishing the site upon commits would be very beneficial. > > Best regards, > Alessandro > > On Thu, 15 Sept 2022 at 23:11, Stamatis Zampetakis <zabe...@gmail.com> > wrote: > >> Hi all, >> >> It's great to see some effort in improving the website. The POC from >> Simhadri looks really cool; I didn't check the content but I love the look >> and feel. >> >> Now regarding the current process for modifying and updating the website >> there is some info in this relatively recent thread [1]. >> >> Moving forward, I would really like to have the source code of the >> website (markdown etc) in the main repo of the project [2], and use GitHub >> actions to automatically build and push the content to the site repo [3] >> per commit basis. >> This workflow is used in Apache Calcite and I find it extremely >> convenient. >> >> Best, >> Stamatis >> >> [1] https://lists.apache.org/thread/4b6x4d6z4tgnv4mo0ycg30y4dlt0msbd >> [2] https://github.com/apache/hive >> [3] https://github.com/apache/hive-site >> >> On Thu, Sep 15, 2022 at 10:50 PM Ayush Saxena <ayush...@gmail.com> wrote: >> >>> Owen, >>> I am not sure if I am catching you right, But now the repository for the >>> website has changed, we no longer use our main *hive.git* repository >>> for the website, We are using the* hive-site *repository for the >>> website, The migration happened this year January I suppose. >>> >>> Can give a check to the set of commit here from: gmcdonald >>> <https://github.com/apache/hive-site/commits?author=gmcdonald> and >>> Humbedooh <https://github.com/apache/hive-site/commits?author=Humbedooh> >>> https://github.com/apache/hive-site/commits/main >>> >>> Now whatever you push to main branch of hive-site( >>> https://github.com/apache/hive-site) it gets published on the *asf-site* >>> branch by the buildbot( >>> https://github.com/apache/hive-site/commits/asf-site) >>> >>> Simhadri's changes will be directed to the main branch of the hive-site >>> repo and they will get auto published on the asf-site branch, I tried this >>> a couple of months back and it indeed worked that way. Let me know if we >>> are missing anything on this, I tried to find threads around this but not >>> sure if it is in private@ or so, couldn't find, I will try again and if >>> there is something around that what needs to be done, I will have a word >>> with the Infra folks and get that sorted, if it isn't already. >>> >>> -Ayush >>> >>> On Fri, 16 Sept 2022 at 01:49, Owen O'Malley <owen.omal...@gmail.com> >>> wrote: >>> >>>> Look at the threads and talk to Apache Infra. They couldn't make it >>>> work before. We would have needed to manually publish to the asf-site >>>> branch. >>>> >>>> On Thu, Sep 15, 2022 at 7:54 PM Simhadri G <simhadri...@gmail.com> >>>> wrote: >>>> >>>>> Thanks Ayush, Pau Tallada and Owen O'Malley for the feedback! >>>>> >>>>> @Owen , This website revamp indeed replaces the website with markdown >>>>> as you have mentioned. I have referred to your PR for some of the content >>>>> for the site. >>>>> The actual code for the website is here: >>>>> https://github.com/simhadri-g/hive-site/tree/new-site >>>>> >>>>> Once we add markdown files to the source code under /content/ , hugo >>>>> will rebuild the files and generate the static html files in ./public/ >>>>> directory. >>>>> I have copied over these static files to a separate repo and >>>>> temporarily hosted it with gh-pages to start the mail chain. >>>>> >>>>> For the final site, I am already trying to automate this with github >>>>> actions. So, as soon as any new changes are made to the site branch, the >>>>> github actions will automatically tigger and update the site. >>>>> >>>>> Thanks! >>>>> >>>>> On Fri, Sep 16, 2022 at 12:17 AM Owen O'Malley <owen.omal...@gmail.com> >>>>> wrote: >>>>> >>>>>> I found it - https://github.com/apache/hive/pull/1410 >>>>>> >>>>>> On Thu, Sep 15, 2022 at 6:42 PM Owen O'Malley <owen.omal...@gmail.com> >>>>>> wrote: >>>>>> >>>>>>> I had a PR to replace the website with markdown. Apache Infra was >>>>>>> supposed to make it autopublish. *sigh* >>>>>>> >>>>>>> .. Owen >>>>>>> >>>>>>> On Thu, Sep 15, 2022 at 4:23 PM Pau Tallada <tall...@pic.es> wrote: >>>>>>> >>>>>>>> Hi, >>>>>>>> >>>>>>>> Great work! >>>>>>>> +1 on updating it as well >>>>>>>> >>>>>>>> Missatge de Ayush Saxena <ayush...@gmail.com> del dia dj., 15 de >>>>>>>> set. 2022 a les 17:40: >>>>>>>> >>>>>>>>> Hi Simhadri, >>>>>>>>> Thanx for the initiative, +1 on updating our current website. >>>>>>>>> The new website looks way better than the existing one. >>>>>>>>> Can create a Jira and link this to that after a couple of days if >>>>>>>>> there aren’t any objections to the move, so as people can drop further >>>>>>>>> suggestions over there. >>>>>>>>> >>>>>>>>> -Ayush >>>>>>>>> >>>>>>>>> > On 15-Sep-2022, at 8:33 PM, SG <simhadri...@gmail.com> wrote: >>>>>>>>> > >>>>>>>>> > Hi Everyone, >>>>>>>>> > >>>>>>>>> > The existing apache hive website https://hive.apache.org/ >>>>>>>>> hasn't been >>>>>>>>> > updated for a very long time. Additionally, I was not able to >>>>>>>>> build the >>>>>>>>> > docker image associated with the site to test out new changes as >>>>>>>>> well. >>>>>>>>> > https://github.com/apache/hive-site >>>>>>>>> > >>>>>>>>> > Since the website is the front page of the project, I believe it >>>>>>>>> would be >>>>>>>>> > good to revamp the apache hive website with the latest features >>>>>>>>> and >>>>>>>>> > releases. >>>>>>>>> > >>>>>>>>> > As a result, I have spent some time setting up an initial draft >>>>>>>>> of the >>>>>>>>> > website. There are still quite a few things that still need to be >>>>>>>>> > added/updated in the draft. Here is the prototype site that I >>>>>>>>> put together >>>>>>>>> > so everyone could check it out: >>>>>>>>> https://simhadri-g.github.io/hive-site-hugo/ >>>>>>>>> > >>>>>>>>> > The new website is based on Hugo. Hugo, is one of the most >>>>>>>>> popular >>>>>>>>> > open-source static site generators. I was able to get a hugo >>>>>>>>> version of the >>>>>>>>> > site up very quickly with a landing page and docs and hugo also >>>>>>>>> makes >>>>>>>>> > maintaining the site very simple. >>>>>>>>> > >>>>>>>>> > Please have a look. Any feedback is much appreciated. >>>>>>>>> > >>>>>>>>> > Existing website: https://hive.apache.org/ >>>>>>>>> > New website: https://simhadri-g.github.io/hive-site-hugo/ >>>>>>>>> > >>>>>>>>> > Thanks! >>>>>>>>> > Simhadri G >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> ---------------------------------- >>>>>>>> Pau Tallada Crespí >>>>>>>> Departament de Serveis >>>>>>>> Port d'Informació Científica (PIC) >>>>>>>> Tel: +34 93 170 2729 >>>>>>>> ---------------------------------- >>>>>>>> >>>>>>>>