Hi all,
I am developing the website based on the templates and I'd like to
discuss about the technologies to be used. I am personally in favor of
static generation, since:
- It's easier to maintain
- Changes can happen in a pull-request process.
- No need for a database or any external resources
- It's fast (because it's static)
- Can be deployed using Github's infrastructure
- Templates can be easily adapted
We already do this with the Forge 1 website and it's playing well so
far. However since I am not a big fan of Ruby, I am playing a bit with
JBake (which uses Freemarker) and found it quite interesting.
We could make it part of a CI job, and fire when changes in the
repository happens.
The development branch uses JSF+JPA and it's quite a burden to maintain
(sync changes to DB, etc) and it's slow.
I believe the best would be having the data available in Github as a
JSON/YAML file and use that in the website generation. Docs can also be
generated inside the website through git submodules (with the forge/docs
repository).
There is the advantage of not needing extra resources (Openshift gears
for example).
Thoughts?
--
*George Gastaldi | Senior Software Engineer*
JBoss Forge Team
T: +55 11 3524-6169
M: +55 47 9711-1000
Red Hat
Better technology. Faster innovation. Powered by community collaboration.
See how it works at
www.redhat.com <
http://www.redhat.com/>
LinkedIn <
http://www.linkedin.com/company/3258288> Youtube
<
https://www.youtube.com/redhatlatam>