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
