Hi VCL community,

I noticed VCL is still serving its site from SVN with help of the Apache CMS. 
At the Apache Celix 
project we decided to move away from the CMS and move towards git for serving 
our website [1]. 
This because the CMS was introduced in 2010 and is currently not accepting any 
new projects. With 
the move to e.g. a static site generator as Hugo we're sure that we still can 
update the site when the 
ASF CMS will be decommissioned.

The master branch contains the actual website sources whereas the generated 
website is served 
from the asf-site branch. Hugo is being used as static website generator. 
Content is written in 
Markdown.

I had a look at VCL its site and it was quite do-able to migrate VCL its site 
to use Hugo as well. An 
example of Hugo its output is (for demo purposes only) available on [2]. These 
are the existing
markdown files with a slightly changed header.

Moving to git can enlarge the visibility of how projects are functioning. Next 
to that, new contributors 
can just create a pull request against the website repository if they find 
anything they want to 
improve. An 'Edit on GitHub' button can be added as well to the site, e.g. an 
example of a page on
the Celix website [3]

If the community is interested in this move what I propose:
- Someone from the PMC to request a new git repository for the website (e.g. 
vcl-site) via [4]
- Me creating the pull request from the repository I am temporarily using for 
the website contents [5] 
to the official vcl-site repository
- Create a Jenkins job to automatically build the site after changes happen on 
the master branch.
- When the pull request is reviewed and merged ask INFRA to move over from the 
current svnpubsub
to the gitpubsub approach and remove VCL from the Apache CMS.

All the URLs are still the same so the SEO score is not influenced in any way.

I'd like to hear everyone's opinion on this :)

Best regards,
Roy

[1] https://github.com/apache/celix-site
[2] http://vcl.roylenferink.nl/
[3] http://celix.apache.org/contributing/releasing.html
[4] https://gitbox.apache.org/setup/newrepo.html
[5] https://github.com/rlenferink/vcl-site

Reply via email to