Thank you. Wouldn't committing (and PRing) them one-by-one pollute the git log and mailing lists too much?
On Oct 24, 2016 5:26 PM, "Mike Percy" <mpe...@apache.org> wrote: > Feel free to do it per-file if you want. Looks good to me > > On Mon, Oct 24, 2016 at 4:14 PM, Balazs Donat Bessenyei < > bes...@cloudera.com > > wrote: > > > I have commenced moving the Developer Section to the git repo. > > > > There is a WIP pull request available at https://github.com/apache/ > > flume/pull/77 > > > > I'm planning to add more e-mail templates to the HowToRelease.md and > > commit all docs in a single commit, but reviews and comments are > > welcome in the meanwhile. > > > > > > Thank you, > > > > Donat > > > > On Fri, Oct 21, 2016 at 6:07 PM, Mike Percy <mpe...@apache.org> wrote: > > > Thanks, Donat. +1 on moving the docs. > > > > > > Regarding the web site source code, it can reside in svn or git however > > it > > > should continue using the standard ASF site infrastructure [1] for > > hosting > > > content which consists only of static rendered HTML content. Our > options > > > for pushing that rendered HTML are either svnpubsub[2] or gitpubsub[3] > > > which are basically the same thing - commit HTML and it gets pushed > live > > to > > > the web site. > > > > > > If someone wants to redesign the site or improve the site template, I > > would > > > certainly welcome that. > > > > > > As a comparison point with another ASF project I am involved in, on > > Apache > > > Kudu we use the software used for GitHub pages (Jekyll) to render the > > site. > > > The web site source code is in the gh-pages branch in Git [4]. The site > > is > > > mostly written in Markdown and we wrote a script [5] that locally > renders > > > the site to static HTML content and checks in the rendered content to > the > > > Kudu gitpubsub repository [6]. > > > > > > In Flume, we basically do the same thing but but instead of Jekyll we > use > > > Sphinx and the site source code is primarily ReStructuredText. The site > > > lives in its own svn repo [7]. We push rendered HTML tent to an > svnpubsub > > > repository for Flume [8] which is controlled by the ASF CMS [9]... > IIRC, > > > the CMS takes care of invoking the rendering part instead of having a > > local > > > script to do it. This is kind of documented in the How to Release guide > > for > > > Flume [10]. > > > > > > If someone just wanted to change the look & feel of the web site they > > could > > > easily do it with a little HTML/CSS knowledge and some reading up on > > > Sphinx. The web site template could be changed to something nicer (it's > > > using some kind of stock template right now). The existing .rst content > > > would not need to be modified at all, probably. > > > > > > If someone wanted to switch the whole web site to some other system, > like > > > Jekyll, obviously it's a bigger change but if they were determined > then I > > > don't think anyone would try to stop them, assuming it's an > improvement! > > > > > > Hope this helps, > > > Mike > > > > > > [1] https://www.apache.org/dev/project-site.html > > > [2] http://svn.apache.org/viewvc/subversion/trunk/tools/ > > > server-side/svnpubsub/ > > > [3] https://www.apache.org/dev/gitpubsub.html > > > [4] https://github.com/apache/kudu/tree/gh-pages > > > [5] https://github.com/apache/kudu/blob/gh-pages/site_tool > > > [6] https://git-wip-us.apache.org/repos/asf?p=kudu-site.git;a= > > > shortlog;h=refs/heads/asf-site > > > [7] https://svn.apache.org/repos/asf/flume/site/trunk/ > > > [8] https://svn.apache.org/repos/infra/websites/production/flume/ > > > [9] https://www.apache.org/dev/cms.html > > > [10] > > > https://cwiki.apache.org/confluence/display/FLUME/How+ > > to+Release#HowtoRelease-Updatethewebsite > > > > > > On Thu, Oct 20, 2016 at 2:59 PM, Balazs Donat Bessenyei < > > bes...@cloudera.com > > >> wrote: > > > > > >> As nobody has objected in ~48 hours, I'll open a pull request about > this > > >> soon. > > >> > > >> Regarding the whole site thing: AFAIK, the site contents have to > > >> reside in SVN, because that's how ASF infrastructure works now. > > >> > > >> First, I'll work on moving the Developer Section to > > >> https://github.com/apache/flume , then we'll see what else we can do. > > >> > > >> > > >> Thank you, > > >> > > >> Donat > > >> > > >> On Thu, Oct 20, 2016 at 12:41 PM, UMESH CHAUDHARY < > umesh9...@gmail.com> > > >> wrote: > > >> > +1 for moving wiki and web contents into GitHub. It would be easier > to > > >> > manage. Also, +1 for improving our website. > > >> > > > >> > On Thu, 20 Oct 2016 at 15:42 Lior Zeno <liorz...@gmail.com> wrote: > > >> > > > >> > +1 for moving the whole site as well. I wish we could improve our > > >> frontend > > >> > to become a bit more appealing. > > >> > > > >> > On Thu, Oct 20, 2016 at 11:53 AM, Attila Simon <s...@cloudera.com> > > >> wrote: > > >> > > > >> >> +1 > > >> >> Essentially moving whole site (all web content) to scm would help > > >> >> contribution. > > >> >> > > >> >> Cheers, > > >> >> Attila > > >> >> > > >> >> On Tuesday, 18 October 2016, Balazs Donat Bessenyei < > > >> bes...@cloudera.com> > > >> >> wrote: > > >> >> > > >> >> > Hi All, > > >> >> > > > >> >> > As it's kind of difficult to get permissions in the wiki to edit > > pages > > >> >> > like https://cwiki.apache.org/confluence/display/FLUME/How+to+ > > >> Contribute > > >> >> > , I suggest moving contents to the git repository into files like > > >> >> > CONTRIBUTING.md, etc. > > >> >> > > > >> >> > I'd be happy to create the files and move the current texts. > > >> >> > > > >> >> > Please, let me know your thoughts. > > >> >> > > > >> >> > > > >> >> > Thank you, > > >> >> > > > >> >> > Donat > > >> >> > > > >> >> > > >> >> > > >> >> -- > > >> >> > > >> >> *Attila Simon* > > >> >> Software Engineer > > >> >> Email: s...@cloudera.com > > >> >> > > >> >> [image: Cloudera Inc.] > > >> >> > > >> > > >