Re: [Mentors] Fixing Heron Docs

2019-08-09 Thread Ning Wang
Thanks a lot for the great work! Finally I can build the website successfully on my laptop! I feel they are just two versions and should be manually manageable. :) We need to do better job to keep the bazel version updated in script/doc though. Then when we have a release, I think we can make

Re: [Mentors] Fixing Heron Docs

2019-08-09 Thread Josh Fischer
Hey All, Thanks to help of Chethan we have a first pass of versioned documentation for Heron 0.20.0-incubating release as well as the ability to generate the pydocs on our build. I think the final step is to decide how we want to associate the Heron version with the compatible Bazel version for

Re: [Mentors] Fixing Heron Docs

2019-07-10 Thread Josh Fischer
Hi All, I started working on the pydocs for the heron site hoping to reuse the scripts that were used in the old project site, I see that bash script to created the pydocs expected a package to be downloaded from PIP to create them. At this time for releases I don't think we have

Re: [Mentors] Fixing Heron Docs

2019-06-25 Thread Josh Fischer
Ok thanks Dave. "The selection of these logo displays must be Vendor Neutral."? On Tue, Jun 25, 2019 at 12:23 PM Dave Fisher wrote: > Hi - > > > On Jun 25, 2019, at 9:32 AM, Josh Fischer wrote: > > > > Hi All, > > > > I'm almost done with the static doc framework migration. I have a couple >

Re: [Mentors] Fixing Heron Docs

2019-06-25 Thread Josh Fischer
Hi All, I'm almost done with the static doc framework migration. I have a couple of questions. 1. Do we want to have a place in the page to display companies using Heron? Can/Should we do this? 2. Do we want to have a place for a Blog on the site? I assume this would be release notes and what

Re: [Mentors] Fixing Heron Docs

2019-05-22 Thread Josh Fischer
I went ahead and moved forward on using Docusarus for our docs. I opened a PR for feedback as I go. It can be found here -> https://github.com/apache/incubator-heron/pull/3270. Out of the box Docusarus comes with a template to do blog posts and show companies that are using the software. I

Re: [Mentors] Fixing Heron Docs

2019-05-21 Thread Josh Fischer
Hey All, Did a little more looking at this. I did a little more looking into Docusarus. My quick scan of the web page was incorrect.. I think Docusarus would replace the current framework that our site is built with (Hugo). So. While versioning the site with Docusaurus would be fairly simple.

Re: [Mentors] Fixing Heron Docs

2019-05-21 Thread Simon Weng
Certainly I don’t know much about documentation tooling, but I heard good things about Docusarus, and also Gitbook. On Tue, May 21, 2019 at 8:16 AM Josh Fischer wrote: > Ok sounds good. Thanks. > > On Tue, May 21, 2019 at 2:37 AM Ning Wang wrote: > > > Looks good~ > > > > For the move, I

Re: [Mentors] Fixing Heron Docs

2019-05-21 Thread Josh Fischer
Ok sounds good. Thanks. On Tue, May 21, 2019 at 2:37 AM Ning Wang wrote: > 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

Re: [Mentors] Fixing Heron Docs

2019-05-21 Thread Ning Wang
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

Re: [Mentors] Fixing Heron Docs

2019-05-20 Thread Josh Fischer
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

Re: [Mentors] Fixing Heron Docs

2019-05-17 Thread Josh Fischer
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 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

Re: [Mentors] Fixing Heron Docs

2019-05-17 Thread Ning Wang
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 wrote: > My responses are Inlined > >

Re: [Mentors] Fixing Heron Docs

2019-05-17 Thread Josh Fischer
My responses are Inlined On Wed, May 15, 2019 at 1:37 PM Dave Fisher 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 >

Re: [Mentors] Fixing Heron Docs

2019-05-15 Thread Josh Fischer
Ping *** On Fri, May 10, 2019 at 11:14 AM Josh Fischer 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

Re: [Mentors] Fixing Heron Docs

2019-05-10 Thread Josh Fischer
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

Re: [Mentors] Fixing Heron Docs

2019-04-26 Thread Dave Fisher
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 wrote: > > Sending this again. I think the

Re: [Mentors] Fixing Heron Docs

2019-04-24 Thread Josh Fischer
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

Re: [Mentors] Fixing Heron Docs

2019-04-23 Thread Josh Fischer
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 wrote: > Cool. > >

Re: [Mentors] Fixing Heron Docs

2019-04-22 Thread Ning Wang
Cool. On Mon, Apr 22, 2019 at 10:31 AM Josh Fischer 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 wrote: > > > Nice! I have access to Jenkins. Please let me know if you need

Re: [Mentors] Fixing Heron Docs

2019-04-22 Thread Josh Fischer
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 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

Re: [Mentors] Fixing Heron Docs

2019-04-22 Thread Ning Wang
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 wrote: > Just an update on the heron doc website. The actual website build has been > fixed. I sent an email out to bui...@apache.org asking about how to > implement the

Re: [Mentors] Fixing Heron Docs

2019-04-22 Thread Josh Fischer
Just an update on the heron doc website. The actual website build has been fixed. I sent an email out to bui...@apache.org 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.

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Ning Wang
Great! On Wed, Apr 3, 2019 at 4:25 PM Josh Fischer 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 wrote: > > > Hi Josh, > > > > I see you in the group. Are you all set? > > > > Regards, > > Dave > > > > > On Apr 3,

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Josh Fischer
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 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 wrote: > > > > Email stripped the image out. Please

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
Hi Josh, I see you in the group. Are you all set? Regards, Dave > On Apr 3, 2019, at 12:02 PM, Dave Fisher wrote: > > Email stripped the image out. Please send it directly. > >> On Apr 3, 2019, at 11:54 AM, Josh Fischer wrote: >> >> Ok went to that link and nothing and authed with apache,

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
Email stripped the image out. Please send it directly. > On Apr 3, 2019, at 11:54 AM, Josh Fischer 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

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Josh Fischer
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 wrote: > Infra has a question: > > Could you please have him submit a screenshot of what >

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
Infra has a question: Could you please have him submit a screenshot of what 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 wrote: >

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Ning Wang
@Yao, @Sree and @*Eren, any of you set up the github hookup successfully? If it is completed, you should see a green "Squash and merge" button in a PR.* On Wed, Apr 3, 2019 at 11:19 AM Dave Fisher wrote: > It looks like you are missing from the heron committers group on Git Hub. > I’m asking

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
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 wrote: > > I do have 2FA enabled. I've also tried to log in/ log out. No

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
> On Apr 3, 2019, at 10:49 AM, Josh Fischer 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

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
> On Apr 3, 2019, at 10:49 AM, Josh Fischer 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

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Josh Fischer
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.

Re: [Mentors] Fixing Heron Docs

2019-04-03 Thread Dave Fisher
Hi - TL:DR - The project should definitely use gitpubsub approach. > On Mar 28, 2019, at 7:08 PM, Josh Fischer 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

Re: [Mentors] Fixing Heron Docs

2019-03-22 Thread Ning Wang
Yeah. More information can be found here: https://github.com/apache/incubator-heron/blob/master/website/README.md Heron's documentation was primarily built using the following components: Hugo --- Static site generator GulpJS --- Build tool for static assets Twitter Bootstrap --- Sass/CSS and

Re: [Mentors] Fixing Heron Docs

2019-03-22 Thread Ning Wang
Thanks a lot for the clarifications! On Fri, Mar 22, 2019 at 10:26 AM Dave Fisher 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 wrote: > > > > Hey

Re: [Mentors] Fixing Heron Docs

2019-03-22 Thread Dave Fisher
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 wrote: > > Hey All, > > With the heavy lifting behind us on the Bazel upgrade, I think the next > task we should tackle is

Re: [Mentors] Fixing Heron Docs

2019-03-22 Thread Ning Wang
Agreed~ For 1, 2. Is there a "more standard" place for Apache projects? Is there any concerns with GH hosting? 3. Yeah. At least on mac I remember I got an make error when I tried to release. I haven't got time to work on it so far. 4. Is a vote required by Apache? On Fri, Mar 22, 2019 at 9:51

[Mentors] Fixing Heron Docs

2019-03-22 Thread Josh Fischer
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? 2. If not where do they need to live? 3. If I remember correctly, some steps