Thanks everyone, I will begin with creating the PR and share the link in this thread soon.
Thanks Simhadri G On Sat, 24 Sep 2022, 04:52 Ayush Saxena, <ayush...@gmail.com> wrote: > Thanx Everyone, > Almost a week and we don’t seems to have any objections to start with up > revamp task with hive-site repo for now. > > Other things as mentioned can be followed up and we can try to ask folks > to establish a PMC consensus if the need be for the futher migration tasks. > > Simhadri, would be good to create a Jira and link the PR and drop the link > here in the thread as well, so as people interested can drop suggestions > regarding the design and content of the website over there, for anything > else we can always come back here if we are blocked on something, or if > something more needs to be done in this context. > > -Ayush > > On 21-Sep-2022, at 6:35 PM, Stamatis Zampetakis <zabe...@gmail.com> wrote: > > > > The javadocs are currently in svn and they can remain there for the > moment. Eventually, they could be moved to a hive-site repository and for > sure we don't want them in the main hive repo. I don't see an immediate > need to change the place where javadocs are stored but if needed we can > raise a JIRA ticket and continue the discussion there. It's not a good idea > to discuss under a closed issue/PR. > > The hive-site repo is always gonna be the place for storing the generated > website (html files etc). When you talk about moving back to the hive repo > I guess you refer to the source/markdown files. The decision to change the > process of publishing the website will probably require a PMC vote with > lazy consensus. > > I agree that we can start by updating the current setup. Then we can kick > off the discussion about moving the website sources to hive repo and start > publishing from there. I don't know if we need to move the javadocs, so we > can postpone this discussion till we hit an obstacle. > > Best, > Stamatis > > On Mon, Sep 19, 2022 at 12:01 PM Simhadri G <simhadri...@gmail.com> wrote: > >> 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 >>>>>>>>>> ---------------------------------- >>>>>>>>>> >>>>>>>>>>