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 <[email protected] > 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 <[email protected]> > 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 <[email protected]> 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 <[email protected]> > wrote: > > > >> +1 > >> Essentially moving whole site (all web content) to scm would help > >> contribution. > >> > >> Cheers, > >> Attila > >> > >> On Tuesday, 18 October 2016, Balazs Donat Bessenyei < > [email protected]> > >> 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: [email protected] > >> > >> [image: Cloudera Inc.] > >> >
