Looks good~ For the move, I think we don't really need to wait for the release. Especially we may need to have a "master" version and other versions for different releases.
How far back might depends on how easy it is to generate web pages. :) It might be good enough to start having the pages after moving to Apache package name (0.20.0) so it is only one version back. On Mon, May 20, 2019 at 8:24 PM Josh Fischer <[email protected]> wrote: > Good Evening, > > I've been looking around the Pulsar repo to see how they version their > docs.. It looks like they are using > Docusarus -> https://docusaurus.io/docs/en/versioning. This looks like a > nice little tool that could handle the versioning for us. > > A question I still have.. Is it more important to move where the static > pages are served from with the added Apache information and then work on > versioning the docs? I imagine we would have to manually trigger this page > deployment only once to get it moved. Or should wait to move the site once > a new release is created and add in all the automation before hand? > > Finally, how far back to do we go to try and match the documentation to the > version? > > On Fri, May 17, 2019 at 11:04 PM Ning Wang <[email protected]> wrote: > > > got it. that is small enough then :) thx > > > > On Fri, May 17, 2019 at 7:33 PM Josh Fischer <[email protected]> > wrote: > > > > > I just built the static site on my local. The zip file of the website > is > > > 15.1 MB. > > > > > > On Fri, May 17, 2019 at 6:03 PM Ning Wang <[email protected]> > wrote: > > > > > > > I think it makes sense for each release to have a separated > > doc/website. > > > It > > > > might be a question though if the website should be included in the > > > > release. I am also curious how big the zip file of the website is? > > > > > > > > > > > > > > > > On Fri, May 17, 2019 at 6:48 AM Josh Fischer <[email protected]> > > > wrote: > > > > > > > > > My responses are Inlined > > > > > > > > > > On Wed, May 15, 2019 at 1:37 PM Dave Fisher <[email protected] > > > > > > wrote: > > > > > > > > > > > A few thoughts about the website. There are two parts to > consider. > > > > > > > > > > > > (1) The constant part that talks about the Heron project, where > > > > resources > > > > > > are and how to contribute to it. This part includes linkages to > ASF > > > > > > resources and also the proper download pages etc. > > > > > > > > > > > > This part should be published at any time and I suggest that the > > > > Jenkins > > > > > > build be triggered by changes to the repository. This is why many > > > > > projects > > > > > > have a separate repository for the website. > > > > > > > > > > > > > > > *** I do have a fair amount of this merged into master. I looked > at > > > > > another incubating project and reused a lot of what they have done. > > > The > > > > > static site just hasn’t been updated yet. If think this should go > > out > > > > > before we move where the site is served from I think we can make > that > > > > > happen. Please advise. > > > > > > > > > > > > > > > > > > > > > > > See the following for missing issues: > > > > > > https://whimsy.apache.org/pods/project/heron - go to > > > > > > https://whimsy.apache.org/pods/project to find another podling > for > > > > > > comparison. > > > > > > > > > > > > > > > *** see above > > > > > > > > > > > > > > > > > > > > > > > (2) Heron docs ought to be tied together with product releases > > along > > > > with > > > > > > master. It makes sense for a releases docs to be part of a > release > > > > build. > > > > > > Some projects even include release docs with a binary convenience > > > > > release. > > > > > > > > > > > > > > > > *** ok would have to think about this approach a little more. I > > think > > > I > > > > > misunderstood the reasoning behind separating the website from the > > > > code. I > > > > > do this would be an easier to manage workflow. I believe the > > current > > > > set > > > > > up builds all static content and Java/Py docs from the same > command. > > > We > > > > > may have to do a little more work to separate the two. > > > > > > > > > > *** Any one else have any thoughts? Did I miss anything? > > > > > > > > > > > > > > > > Regards, > > > > > > Dave > > > > > > > > > > > > > On May 10, 2019, at 9:14 AM, Josh Fischer <[email protected] > > > > > > wrote: > > > > > > > > > > > > > > Hey All, > > > > > > > > > > > > > > With the "build asf site" scripts merged into master we should > > > decide > > > > > > which > > > > > > > of the existing Heron Jenkins builds that we want to trigger > > them. > > > > > Ning > > > > > > > brought up a good idea to have differences instances of the > > static > > > > site > > > > > > > running for the different versions of Heron. I agree that this > > is > > > a > > > > > good > > > > > > > idea. While I don't think that easily possible today, we can > > start > > > > to > > > > > > > design our release process to work with this idea. We could > > create > > > > new > > > > > > > docs to be published for each successful release as opposed to > a > > > > > > scheduled > > > > > > > cron job? Thoughts? > > > > > > > > > > > > > > On Fri, Apr 26, 2019 at 11:03 AM Dave Fisher < > > > [email protected]> > > > > > > wrote: > > > > > > > > > > > > > >> Hi Josh, > > > > > > >> > > > > > > >> I responded to your more recent email. In order to create and > > > manage > > > > > > >> Jenkins jobs ids need to be added to the hudson-jobadmin LDAP > > > group > > > > > by > > > > > > a > > > > > > >> PMC Chair. > > > > > > >> > > > > > > >> Looking for that now. > > > > > > >> > > > > > > >> Regards, > > > > > > >> Dave > > > > > > >> > > > > > > >>> On Apr 24, 2019, at 4:09 PM, Josh Fischer < > [email protected] > > > > > > > > wrote: > > > > > > >>> > > > > > > >>> Sending this again. I think the apache servers stripped out > > the > > > > > image > > > > > > on > > > > > > >>> the last email I sent. > > > > > > >>> > > > > > > >>> Here is my original message: > > > > > > >>> > > > > > > >>> I was looking around the site > > > > > > >> https://builds.apache.org/view/Heron%20Jobs/ . > > > > > > >>> I've logged in, but I don't see a way to create a freestyle > > > > > > >>> project/pipeline/anything in the UI. Am I missing something > > > > > obvious? > > > > > > >>> > > > > > > >>> Please see the google drive link below for the image I was > > trying > > > > to > > > > > > >> share > > > > > > >>> before. > > > > > > >>> > > > > > > >>> > > > > > > >> > > > > > > > > > > > > > > > > > > > > > https://drive.google.com/file/d/1BGjltTiRNZRfBaT5d2heTKEfKfUe0Irz/view?usp=sharing > > > > > > >>> > > > > > > >>> On Tue, Apr 23, 2019 at 9:34 PM Josh Fischer < > > > [email protected]> > > > > > > >> wrote: > > > > > > >>> > > > > > > >>>> Hey All, > > > > > > >>>> > > > > > > >>>> I was looking around the site > > > > > > >> https://builds.apache.org/view/Heron%20Jobs/ . > > > > > > >>>> I've logged in, but I don't see a way to create a freestyle > > > > > > >>>> project/pipeline/anything in the UI.. See attached image. > > Am I > > > > > > missing > > > > > > >>>> something? > > > > > > >>>> > > > > > > >>>> > > > > > > >>>> > > > > > > >>>> On Mon, Apr 22, 2019 at 1:09 PM Ning Wang < > > [email protected] > > > > > > > > > > wrote: > > > > > > >>>> > > > > > > >>>>> Cool. > > > > > > >>>>> > > > > > > >>>>> On Mon, Apr 22, 2019 at 10:31 AM Josh Fischer < > > > > [email protected] > > > > > > > > > > > > >>>>> wrote: > > > > > > >>>>> > > > > > > >>>>>> I do too. I’ll resend the email and try to move forward > > this > > > > > week. > > > > > > >>>>> Ning, > > > > > > >>>>>> If I get stuck Ill Let you know. > > > > > > >>>>>> > > > > > > >>>>>> On Mon, Apr 22, 2019 at 12:02 PM Ning Wang < > > > > [email protected]> > > > > > > >>>>> wrote: > > > > > > >>>>>> > > > > > > >>>>>>> Nice! I have access to Jenkins. Please let me know if you > > > need > > > > > > helps > > > > > > >>>>> from > > > > > > >>>>>>> me. > > > > > > >>>>>>> > > > > > > >>>>>>> On Mon, Apr 22, 2019 at 9:40 AM Josh Fischer < > > > > > [email protected]> > > > > > > >>>>>> wrote: > > > > > > >>>>>>> > > > > > > >>>>>>>> Just an update on the heron doc website. The actual > > website > > > > > build > > > > > > >>>>> has > > > > > > >>>>>>> been > > > > > > >>>>>>>> fixed. I sent an email out to [email protected] asking > > > about > > > > > how > > > > > > to > > > > > > >>>>>>>> implement the process and describing what we would need > in > > > the > > > > > > >>>>> server > > > > > > >>>>>> to > > > > > > >>>>>>>> build about a week ago. I didn’t get a reply back, I > will > > > try > > > > > > again > > > > > > >>>>>> this > > > > > > >>>>>>>> week. > > > > > > >>>>>>>> > > > > > > >>>>>>>> > > > > > > >>>>>>>> On Wed, Apr 3, 2019 at 9:08 PM Ning Wang < > > > > [email protected]> > > > > > > >>>>> wrote: > > > > > > >>>>>>>> > > > > > > >>>>>>>>> Great! > > > > > > >>>>>>>>> > > > > > > >>>>>>>>> On Wed, Apr 3, 2019 at 4:25 PM Josh Fischer < > > > > > [email protected] > > > > > > > > > > > > > >>>>>>> wrote: > > > > > > >>>>>>>>> > > > > > > >>>>>>>>>> Yes I think I am all set up now. Thank you for your > > help. > > > > > > >>>>>>>>>> > > > > > > >>>>>>>>>> - Josh > > > > > > >>>>>>>>>> > > > > > > >>>>>>>>>> On Wed, Apr 3, 2019 at 3:48 PM Dave Fisher < > > > > > > >>>>> [email protected]> > > > > > > >>>>>>>>> wrote: > > > > > > >>>>>>>>>> > > > > > > >>>>>>>>>>> Hi Josh, > > > > > > >>>>>>>>>>> > > > > > > >>>>>>>>>>> I see you in the group. Are you all set? > > > > > > >>>>>>>>>>> > > > > > > >>>>>>>>>>> Regards, > > > > > > >>>>>>>>>>> Dave > > > > > > >>>>>>>>>>> > > > > > > >>>>>>>>>>>> On Apr 3, 2019, at 12:02 PM, Dave Fisher < > > > > > > >>>>>> [email protected]> > > > > > > >>>>>>>>>> wrote: > > > > > > >>>>>>>>>>>> > > > > > > >>>>>>>>>>>> Email stripped the image out. Please send it > directly. > > > > > > >>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> On Apr 3, 2019, at 11:54 AM, Josh Fischer < > > > > > > >>>>>> [email protected]> > > > > > > >>>>>>>>>> wrote: > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> Ok went to that link and nothing and authed with > > > apache, > > > > > > >>>>> GH, > > > > > > >>>>>> and > > > > > > >>>>>>>> saw > > > > > > >>>>>>>>>>> confirmation of repos. Still no access via UI or > CLI. > > > > > > >>>>>>>>>>>>> Image attached. > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> On Wed, Apr 3, 2019 at 1:46 PM Dave Fisher < > > > > > > >>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> wrote: > > > > > > >>>>>>>>>>>>> Infra has a question: > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> Could you please have him submit a screenshot of > what > > > > > > >>>>>>>>>>> https://gitbox.apache.org/setup/ < > > > > > > >>>>>> https://gitbox.apache.org/setup/ > > > > > > >>>>>>>> > > > > > > >>>>>>>>> says > > > > > > >>>>>>>>>>> after he has authed? He may need to reset his github > > > > linking > > > > > > >>>>>> (reset > > > > > > >>>>>>>>> link > > > > > > >>>>>>>>>> in > > > > > > >>>>>>>>>>> the middle box of the setup page.) > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> Regards, > > > > > > >>>>>>>>>>>>> Dave > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>> On Apr 3, 2019, at 11:19 AM, Dave Fisher < > > > > > > >>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> wrote: > > > > > > >>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>> It looks like you are missing from the heron > > > committers > > > > > > >>>>> group > > > > > > >>>>>>> on > > > > > > >>>>>>>>> Git > > > > > > >>>>>>>>>>> Hub. I’m asking Infra why on Slack. If no answer soon > > > then > > > > > > >>>>> I’ll > > > > > > >>>>>>> file > > > > > > >>>>>>>> a > > > > > > >>>>>>>>>> JIRA. > > > > > > >>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>> Anyone else having issues? > > > > > > >>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>> On Apr 3, 2019, at 11:03 AM, Josh Fischer < > > > > > > >>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> wrote: > > > > > > >>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>> I do have 2FA enabled. I've also tried to log > in/ > > > log > > > > > > >>>>> out. > > > > > > >>>>>>> No > > > > > > >>>>>>>>>>> success. > > > > > > >>>>>>>>>>>>>>> Any suggestions on who I should contact to help > > > > diagnose > > > > > > >>>>> and > > > > > > >>>>>>>> fix? > > > > > > >>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>> On Wed, Apr 3, 2019 at 12:58 PM Dave Fisher < > > > > > > >>>>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> wrote: > > > > > > >>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> On Apr 3, 2019, at 10:49 AM, Josh Fischer < > > > > > > >>>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> wrote: > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> Thanks for the info Dave. I have a couple of > > > > > > >>>>> responses to > > > > > > >>>>>>>> your > > > > > > >>>>>>>>>>>>>>>> questions. > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> (1) Does the project wish to create > documentation > > > in > > > > a > > > > > > >>>>> new > > > > > > >>>>>>>>>>> repository - > > > > > > >>>>>>>>>>>>>>>> say > > > > > > >>>>>>>>>>>>>>>>> apache/incubator-heron-site > > > > > > >>>>>>>>>>>>>>>>> Or should the build use an asf-site branch in > > > > > > >>>>>>>>>>>>>>>>> apache/incubator-heron which just keeps the > > > deployed > > > > > > >>>>>>> content. > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> ** The site build is currently dependent on > Bazel > > > to > > > > > > >>>>>>> generate > > > > > > >>>>>>>>>>> Javadocs. > > > > > > >>>>>>>>>>>>>>>> I > > > > > > >>>>>>>>>>>>>>>>> think we should just have a "asf-site" branch > > that > > > is > > > > > > >>>>> used > > > > > > >>>>>>>>> within > > > > > > >>>>>>>>>>> the > > > > > > >>>>>>>>>>>>>>>>> current repo to serve static files from as it > > would > > > > > > >>>>>> require > > > > > > >>>>>>>> less > > > > > > >>>>>>>>>>> moving > > > > > > >>>>>>>>>>>>>>>>> parts. Not sure if that would cause any issues > > > with > > > > > > >>>>> the > > > > > > >>>>>>>> current > > > > > > >>>>>>>>>>> setup > > > > > > >>>>>>>>>>>>>>>>> though. I was asking Ning a similar question > on > > > how > > > > to > > > > > > >>>>>> set > > > > > > >>>>>>>> this > > > > > > >>>>>>>>>> up > > > > > > >>>>>>>>>>>>>>>> since I > > > > > > >>>>>>>>>>>>>>>>> don't have write access to the repo yet.Hi - > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> Really? - Have you enabled 2FA on GitHub for > your > > > > > > >>>>>>>> joshfischer1108 > > > > > > >>>>>>>>>>> username? > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> I recommend that you get access fixed and then > > work > > > on > > > > > > >>>>>> doing > > > > > > >>>>>>>> the > > > > > > >>>>>>>>>>> build > > > > > > >>>>>>>>>>>>>>>> locally. Once you have that we can work on the > > > Jenkins > > > > > > >>>>>> build > > > > > > >>>>>>>> with > > > > > > >>>>>>>>>>> triggers. > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> (2) Does the website Jenkins box already > support > > > the > > > > > > >>>>> build > > > > > > >>>>>>>>>>> requirements. > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> ** I will look into this. > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> Ask on the-asf.slack.com < > > http://the-asf.slack.com/ > > > > > > > > > > >>>>>>>> #asfinfra - > > > > > > >>>>>>>>>>> tell them it is for a gitpubsub > > > > > > >>>>>>>>>>>>>>>> website build. > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> Regards, > > > > > > >>>>>>>>>>>>>>>> Dave > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>> On Wed, Apr 3, 2019 at 10:43 AM Dave Fisher < > > > > > > >>>>>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> > > > > > > >>>>>>>>>>>>>>>> wrote: > > > > > > >>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> Hi - > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> TL:DR - The project should definitely use > > > gitpubsub > > > > > > >>>>>>> approach. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> On Mar 28, 2019, at 7:08 PM, Josh Fischer < > > > > > > >>>>>>>>> [email protected] > > > > > > >>>>>>>>>>> <mailto:[email protected]>> wrote: > > > > > > >>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> How does everyone want to manage publishing > the > > > > site? > > > > > > >>>>>>> After > > > > > > >>>>>>>>>>> looking at > > > > > > >>>>>>>>>>>>>>>>>> the > > > > > > >>>>>>>>>>>>>>>>>>> docs it seems there are 3 options. Being > that > > we > > > > are > > > > > > >>>>>>> using > > > > > > >>>>>>>>>> git, I > > > > > > >>>>>>>>>>>>>>>> would > > > > > > >>>>>>>>>>>>>>>>>>> thing that gitsubpub would be the path of > least > > > > > > >>>>>>>> resistance?... > > > > > > >>>>>>>>>>> But I > > > > > > >>>>>>>>>>>>>>>>>> can't > > > > > > >>>>>>>>>>>>>>>>>>> find much on how to create the jenkins job. > > > Maybe > > > > > > >>>>> this > > > > > > >>>>>> is > > > > > > >>>>>>>>>> listed > > > > > > >>>>>>>>>>>>>>>>>> somewhere > > > > > > >>>>>>>>>>>>>>>>>>> else in the documentation? Does anyone have > > > other > > > > > > >>>>>>>> suggestions > > > > > > >>>>>>>>>> or > > > > > > >>>>>>>>>>>>>>>> ideas? > > > > > > >>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> Here is link to the guidelines -> > > > > > > >>>>>>>>>>>>>>>>>>> http://www.apache.org/dev/project-site.html > < > > > > > > >>>>>>>>>>> http://www.apache.org/dev/project-site.html>. I copy > > and > > > > > > >>>>> pasted > > > > > > >>>>>>> some > > > > > > >>>>>>>>>>>>>>>> info > > > > > > >>>>>>>>>>>>>>>>>>> below on the different methods of website > > > > publishing > > > > > > >>>>> for > > > > > > >>>>>>>> quick > > > > > > >>>>>>>>>>>>>>>> reference. > > > > > > >>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> - Apache CMS, which provides a simple > > > browser-based > > > > > > >>>>> user > > > > > > >>>>>>>>>>> interface for > > > > > > >>>>>>>>>>>>>>>>>>> editing, staging and publishing site content > in > > > > > > >>>>>> Markdown, > > > > > > >>>>>>>> HTML > > > > > > >>>>>>>>>> or > > > > > > >>>>>>>>>>> any > > > > > > >>>>>>>>>>>>>>>>>> other > > > > > > >>>>>>>>>>>>>>>>>>> source format for which support has been > added. > > > See > > > > > > >>>>> the > > > > > > >>>>>>> CMS > > > > > > >>>>>>>>>>> reference > > > > > > >>>>>>>>>>>>>>>>>>> <https://www.apache.org/dev/cmsref < > > > > > > >>>>>>>>>>> https://www.apache.org/dev/cmsref>> and adoption > > > > > > >>>>>>>>>>>>>>>>>>> <https://www.apache.org/dev/cmsadoption < > > > > > > >>>>>>>>>>> https://www.apache.org/dev/cmsadoption>> for more > > > details. > > > > > > >>>>> The > > > > > > >>>>>>>> Apache > > > > > > >>>>>>>>>>>>>>>>>>> CMS uses svnpubsub as the underlying > mechanism > > > for > > > > > > >>>>>>>> publishing > > > > > > >>>>>>>>> a > > > > > > >>>>>>>>>>> site. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> While this was home grown in Apache and all > the > > > rage > > > > > > >>>>> 7-8 > > > > > > >>>>>>>> years > > > > > > >>>>>>>>>> ago > > > > > > >>>>>>>>>>> when > > > > > > >>>>>>>>>>>>>>>> I > > > > > > >>>>>>>>>>>>>>>>>> used this to port over OpenOffice.org with a > > > reskin. > > > > > > >>>>> This > > > > > > >>>>>>>>> should > > > > > > >>>>>>>>>>> not be > > > > > > >>>>>>>>>>>>>>>>>> used. Infra wants people to stop and there are > > > > > > >>>>> occasional > > > > > > >>>>>>>>>>> publishing > > > > > > >>>>>>>>>>>>>>>> issues. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> - svnpubsub, which allows the static contents > > of > > > a > > > > > > >>>>>>>> designated > > > > > > >>>>>>>>>> svn > > > > > > >>>>>>>>>>>>>>>>>> folder > > > > > > >>>>>>>>>>>>>>>>>>> (example < > > > > > > >>>>>>>>>>> > > http://svn.apache.org/repos/asf/ant/site/ant/production/ > > > < > > > > > > >>>>>>>>>>> > > http://svn.apache.org/repos/asf/ant/site/ant/production/ > > > > >>) > > > > > > >>>>>>>>>>>>>>>>>> to > > > > > > >>>>>>>>>>>>>>>>>>> automatically published as the project web > site > > > at > > > > > > >>>>>>>>>>>>>>>>>>> http://project.apache.org/ < > > > > > > >>>>> http://project.apache.org/ > > > > > > >>>>>>> . > > > > > > >>>>>>>> The > > > > > > >>>>>>>>>>> project team can use any site build > > > > > > >>>>>>>>>>>>>>>>>>> mechanism it wants as long as the above > > > > requirements > > > > > > >>>>> are > > > > > > >>>>>>>> met. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> The CMS also uses svnpubsub. Not many new > > projects > > > > or > > > > > > >>>>>>>> podlings > > > > > > >>>>>>>>>> are > > > > > > >>>>>>>>>>> using > > > > > > >>>>>>>>>>>>>>>>>> Subversion other than as required for > releases. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>> - gitpubsub, which allows the static contents > > of > > > a > > > > > > >>>>>>>> designated > > > > > > >>>>>>>>>> git > > > > > > >>>>>>>>>>>>>>>>>>> repository to be served as the website for a > > > > project. > > > > > > >>>>>> git > > > > > > >>>>>>>>> based > > > > > > >>>>>>>>>>>>>>>>>> websites > > > > > > >>>>>>>>>>>>>>>>>>> are typically maintained in a asf-site branch > > to > > > be > > > > > > >>>>>>>> published > > > > > > >>>>>>>>> as > > > > > > >>>>>>>>>>>>>>>>>>> https://project.apache.org < > > > > > > >>>>> https://project.apache.org/ > > > > > > >>>>>>> . > > > > > > >>>>>>>>> They > > > > > > >>>>>>>>>>> can be hosted from your primary > > > > > > >>>>>>>>>>>>>>>>>> project > > > > > > >>>>>>>>>>>>>>>>>>> repo. Typically these will be built as a > > jenkins > > > > job > > > > > > >>>>> or > > > > > > >>>>>> a > > > > > > >>>>>>>>>> buildbot > > > > > > >>>>>>>>>>>>>>>>>> job. It > > > > > > >>>>>>>>>>>>>>>>>>> is recommended that you only have a single > > writer > > > > to > > > > > > >>>>> the > > > > > > >>>>>>>>>> asf-site > > > > > > >>>>>>>>>>>>>>>>>> branch to > > > > > > >>>>>>>>>>>>>>>>>>> avoid potential conflicts. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> I’ve just revised the Incubator’s site build > > since > > > > we > > > > > > >>>>>> have > > > > > > >>>>>>> a > > > > > > >>>>>>>>> mix > > > > > > >>>>>>>>>>> of svn > > > > > > >>>>>>>>>>>>>>>>>> legacy, current analysis and git static > content. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> See https://github.com/apache/incubator < > > > > > > >>>>>>>>>>> https://github.com/apache/incubator> and the > > README.md. > > > > This > > > > > > >>>>> is > > > > > > >>>>>> a > > > > > > >>>>>>>>>>>>>>>>>> jBake site with two Jenkins build steps. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> This should be the approach. Two areas for > > further > > > > > > >>>>>>>> discussion. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> (1) Does the project wish to create > > documentation > > > > in a > > > > > > >>>>>> new > > > > > > >>>>>>>>>>> repository - > > > > > > >>>>>>>>>>>>>>>>>> say apache/incubator-heron-site > > > > > > >>>>>>>>>>>>>>>>>> Or should the build use an asf-site branch > in > > > > > > >>>>>>>>>>>>>>>>>> apache/incubator-heron which just keeps the > > > deployed > > > > > > >>>>>>> content. > > > > > > >>>>>>>>>>>>>>>>>> (2) Does the website Jenkins box already > support > > > the > > > > > > >>>>>> build > > > > > > >>>>>>>>>>> requirements. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>> Hugo --- Static site generator > > > > > > >>>>>>>>>>>>>>>>>>>> GulpJS --- Build tool for static assets > > > > > > >>>>>>>>>>>>>>>>>>>> Twitter Bootstrap --- Sass/CSS and > JavaScript > > > > > > >>>>>>>>>>>>>>>>>>>> Documentation Setup > > > > > > >>>>>>>>>>>>>>>>>>>> Running the Heron documentation locally > > requires > > > > > > >>>>> that > > > > > > >>>>>> you > > > > > > >>>>>>>>> have > > > > > > >>>>>>>>>>> the > > > > > > >>>>>>>>>>>>>>>>>>>> following installed: > > > > > > >>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>> Make > > > > > > >>>>>>>>>>>>>>>>>>>> Node.js > > > > > > >>>>>>>>>>>>>>>>>>>> npm > > > > > > >>>>>>>>>>>>>>>>>>>> pip - install PyYAML>=3.12 > > > > > > >>>>>>>>>>>>>>>>>>>> Go (make sure that your GOPATH and GOROOT > are > > > set) > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> What versions of the above and we can check > with > > > > Infra > > > > > > >>>>>>>> through > > > > > > >>>>>>>>>> the > > > > > > >>>>>>>>>>>>>>>>>> [email protected] <mailto:[email protected]> > > > email. > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> Regards, > > > > > > >>>>>>>>>>>>>>>>>> Dave > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>> On Fri, Mar 22, 2019 at 10:50 AM Josh > Fischer > > < > > > > > > >>>>>>>>>>> [email protected] <mailto:[email protected]>> > > > > > > >>>>>>>>>>>>>>>>>> wrote: > > > > > > >>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> I have some time free over the next week, I > > can > > > > > > >>>>> look > > > > > > >>>>>>> into > > > > > > >>>>>>>>>>> fixing the > > > > > > >>>>>>>>>>>>>>>>>>>>> build.. However, I think we should figure > out > > > the > > > > > > >>>>> repo > > > > > > >>>>>>>>>> situation > > > > > > >>>>>>>>>>>>>>>> first > > > > > > >>>>>>>>>>>>>>>>>>>> with > > > > > > >>>>>>>>>>>>>>>>>>>>> the submodule that is tied to the > > > documentation. > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> My responses are in *bold. * > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> On Fri, Mar 22, 2019 at 12:26 PM Dave > Fisher > > < > > > > > > >>>>>>>>>>> [email protected] <mailto:[email protected] > >> > > > > > > >>>>>>>>>>>>>>>>>>>>> wrote: > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Hi - > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Thanks for asking. This has been on my > list > > to > > > > > > >>>>>> discuss > > > > > > >>>>>>>> with > > > > > > >>>>>>>>>> the > > > > > > >>>>>>>>>>>>>>>> Heron > > > > > > >>>>>>>>>>>>>>>>>>>>>> community. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> The website is seriously non-compliant. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> On Mar 22, 2019, at 9:38 AM, Josh > Fischer < > > > > > > >>>>>>>>>>> [email protected] <mailto:[email protected]>> > > > > > > >>>>>>>>>>>>>>>>>>>> wrote: > > > > > > >>>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> Hey All, > > > > > > >>>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> With the heavy lifting behind us on the > > Bazel > > > > > > >>>>>>> upgrade, I > > > > > > >>>>>>>>>>> think the > > > > > > >>>>>>>>>>>>>>>>>>>> next > > > > > > >>>>>>>>>>>>>>>>>>>>>>> task we should tackle is fixing the > public > > > > docs. > > > > > > >>>>> I > > > > > > >>>>>>> have > > > > > > >>>>>>>> a > > > > > > >>>>>>>>>> few > > > > > > >>>>>>>>>>>>>>>>>>>> questions > > > > > > >>>>>>>>>>>>>>>>>>>>>>> about them. > > > > > > >>>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> 1. Are they still to be served from GH > > pages? > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> No. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> 2. If not where do they need to live? > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> It should be on Apache servers as > > > > > > >>>>> heron.apache.org < > > > > > > >>>>>>>>>>> http://heron.apache.org/> < > > > > > > >>>>>>>>>>>>>>>>>>>>>> http://heron.apache.org/ < > > > > > > >>>>> http://heron.apache.org/>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Many projects build through Jenkins. There > > are > > > > > > >>>>>>>> requirements > > > > > > >>>>>>>>>>> for the > > > > > > >>>>>>>>>>>>>>>>>>>> site > > > > > > >>>>>>>>>>>>>>>>>>>>>> which are scanned. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> There is a page here (needs some updates) > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > https://incubator.apache.org/guides/sites.html > > > > < > > > > > > >>>>>>>>>>> https://incubator.apache.org/guides/sites.html> < > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > https://incubator.apache.org/guides/sites.html > > > > < > > > > > > >>>>>>>>>>> https://incubator.apache.org/guides/sites.html>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Some projects keep a separate GitHub > > > repository > > > > > > >>>>> for > > > > > > >>>>>>> their > > > > > > >>>>>>>>>>> website. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> * I would recommend that we move the docs > > out > > > > of > > > > > > >>>>>> this > > > > > > >>>>>>>> repo > > > > > > >>>>>>>>>> or > > > > > > >>>>>>>>>>> at > > > > > > >>>>>>>>>>>>>>>>>> least > > > > > > >>>>>>>>>>>>>>>>>>>>> remove the submodule. Working within the > > > > submodule > > > > > > >>>>>> has > > > > > > >>>>>>>> been > > > > > > >>>>>>>>>>> quite a > > > > > > >>>>>>>>>>>>>>>>>>>>> difficult task.* > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> There is a lot wrong with the current > > website. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> This page was put onto the Incubator > website > > > > this > > > > > > >>>>>> week. > > > > > > >>>>>>>>> (It’s > > > > > > >>>>>>>>>>> been > > > > > > >>>>>>>>>>>>>>>> my > > > > > > >>>>>>>>>>>>>>>>>>>>>> “distraction” the last few weeks.) > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>> https://incubator.apache.org/clutch/heron.html#errata > > > > > > >>>>>>> < > > > > > > >>>>>>>>>>> > https://incubator.apache.org/clutch/heron.html#errata> > > < > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>> https://incubator.apache.org/clutch/heron.html#errata > > > > > > >>>>>>> < > > > > > > >>>>>>>>>>> > https://incubator.apache.org/clutch/heron.html#errata > > >> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Check out that almost all ASF links, > > > trademarks, > > > > > > >>>>>>>>> disclaimer, > > > > > > >>>>>>>>>>> and > > > > > > >>>>>>>>>>>>>>>>>>>>>> copyrights are not correct on a site scan > > that > > > > is > > > > > > >>>>>>>>>> periodically > > > > > > >>>>>>>>>>>>>>>>>>>> performed. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > https://whimsy.apache.org/pods/project/heron > > > < > > > > > > >>>>>>>>>>> https://whimsy.apache.org/pods/project/heron> < > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > https://whimsy.apache.org/pods/project/heron > > > < > > > > > > >>>>>>>>>>> https://whimsy.apache.org/pods/project/heron>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> 3. If I remember correctly, some steps in > > the > > > > > > >>>>>> Makefile > > > > > > >>>>>>>> are > > > > > > >>>>>>>>>>>>>>>>>>>> currently > > > > > > >>>>>>>>>>>>>>>>>>>>>>> broken for building the static assets. > > Once > > > > > > >>>>> those > > > > > > >>>>>>>> issues > > > > > > >>>>>>>>>> are > > > > > > >>>>>>>>>>>>>>>>>>>>> resolved > > > > > > >>>>>>>>>>>>>>>>>>>>>> is > > > > > > >>>>>>>>>>>>>>>>>>>>>>> there anything else we need to do to > > release > > > > new > > > > > > >>>>> set > > > > > > >>>>>>> of > > > > > > >>>>>>>>>> docs? > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Follow what I listed on 2. > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> What technology is used to build assets > > > > currently? > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> * It looks like is a mix of > technologies.. > > > The > > > > > > >>>>> main > > > > > > >>>>>>> one > > > > > > >>>>>>>>>> being > > > > > > >>>>>>>>>>>>>>>> Gulp. > > > > > > >>>>>>>>>>>>>>>>>>>>> For generating java docs Bazel is used to > > query > > > > > > >>>>>> targets. > > > > > > >>>>>>>>>>> Generating > > > > > > >>>>>>>>>>>>>>>>>>>> python > > > > > > >>>>>>>>>>>>>>>>>>>>> docs pdoc is used. * > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> 4. Does updating the docs require a vote? > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Not normally. The Podling can decide if > you > > > want > > > > > > >>>>> to > > > > > > >>>>>> use > > > > > > >>>>>>>> RTC > > > > > > >>>>>>>>>> or > > > > > > >>>>>>>>>>> CTR. > > > > > > >>>>>>>>>>>>>>>>>>>> Since > > > > > > >>>>>>>>>>>>>>>>>>>>>> everything is in version control I would > > lean > > > to > > > > > > >>>>> CTR! > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> Regards, > > > > > > >>>>>>>>>>>>>>>>>>>>>> Dave > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>>> - Josh > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>>> > > > > > > >>>>>>>>>>>>> > > > > > > >>>>>>>>>>>> > > > > > > >>>>>>>>>>> > > > > > > >>>>>>>>>>> -- > > > > > > >>>>>>>>>> Sent from A Mobile Device > > > > > > >>>>>>>>>> > > > > > > >>>>>>>>> > > > > > > >>>>>>>> -- > > > > > > >>>>>>>> Sent from A Mobile Device > > > > > > >>>>>>>> > > > > > > >>>>>>> > > > > > > >>>>>> -- > > > > > > >>>>>> Sent from A Mobile Device > > > > > > >>>>>> > > > > > > >>>>> > > > > > > >>>> > > > > > > >> > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > >
