camel-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [CONF] Apache Camel > Site Update Ideas
Date Thu, 03 Feb 2011 15:09:00 GMT
    <base href="">
            <link rel="stylesheet" href="/confluence/s/2036/9/1/_/styles/combined.css?spaceKey=CAMEL&amp;forWysiwyg=true"
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="">Site
Update Ideas</a></h2>
    <h4>Page <b>edited</b> by             <a href="">Hadrian
        <div id="versionComment">
        daphne vichot logo proposal<br />
                         <h4>Changes (1)</h4>
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >* a more [serious|^camelcomic.jpg]
(kinda angry) camel (link to [original|])
<br>* a [funny|^camelcomic2.jpg], happier camel (link to [original|])
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Daphne
Vichot, contributed four more proposals for a logo: <br>* [camel with apache feather
carrying messages|^dvichot-camel-logo.jpg] <br> <br></td></tr>
            <tr><td class="diff-unchanged" >Please provide your feedback on the
mailing lists and the irc channel to select a logo. <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h1><a name="SiteUpdateIdeas-Rationale"></a>Rationale</h1>

<p>There is a growing sense in the community that the Camel Web site needs some updating.
The <a href=""
class="external-link" rel="nofollow">precipitating e-mail</a> cited a few key areas
to look at:</p>

	<li>a new logo</li>
	<li>refreshed look and feel for the site</li>
	<li>clearer navigation</li>
	<li>clearer organization of the documentation</li>

<p>In addition the idea of attempting to align the branding of Camel with ServiceMix,
CXF, ActiveMQ, and Karaf was floated. The idea being that the projects are closely aligned
and frequently used together.</p>

<p>A final consideration is that the Apache Infrastructure group is beginning the process
of deprecating Confluence due to a lack of support for the static HTML export plug-in. They
have outlined plans to have all projects host their Web sites from SVN. The infrastructure
group is implementing a CMS system that is currently in use for the main Apache site. However,
they are willing to support any tool chain that produces HTML for publication from SVN.</p>

<p>Recently the board produced a set of <a href=""
class="external-link" rel="nofollow">guidelines</a> that all projects must implement
early next year regarding branding and Web sites.</p>

<h1><a name="SiteUpdateIdeas-ProposedSolutions"></a>Proposed Solutions</h1>

<p>The proposals cover two general areas:</p>
	<li>site design</li>
	<li>site generation</li>

<h2><a name="SiteUpdateIdeas-SiteDesign"></a>Site Design</h2>

<p>The ServiceMix community has been knocking ideas for a site design around for awhile.
There discussions are archived at:</p>

	<li><a href=""
class="external-link" rel="nofollow"></a></li>
	<li><a href=""
class="external-link" rel="nofollow"></a></li>

<p>The generally agreed upon items from the ServiceMix discussion are:</p>
	<li>make it easy for a user to find the most current download for their platform</li>
	<li>make it easy for a user to find documentation and support</li>
	<li>make it easy for interested parties to learn about the community</li>
	<li>boxes highlighting the three main areas are desirable</li>
	<li>a twitter widget is desirable</li>
	<li>simplified navigation is desirable</li>

<p>Lukasz Dywicki, who is helping update the design of the ServiceMix site, has volunteered
some design effort to the Camel community. Attached are two of his proposals:</p>
	<li>a more <a href="/confluence/download/attachments/24186045/camelcomic.jpg?version=1&amp;modificationDate=1291144284000">serious</a>
(kinda angry) camel (link to <a href=""
class="external-link" rel="nofollow">original</a>)</li>
	<li>a <a href="/confluence/download/attachments/24186045/camelcomic2.jpg?version=1&amp;modificationDate=1291144284000">funny</a>,
happier camel (link to <a href=""
class="external-link" rel="nofollow">original</a>)<br/>
Daphne Vichot, contributed four more proposals for a logo:</li>
	<li><a href="/confluence/download/attachments/24186045/dvichot-camel-logo.jpg?version=1&amp;modificationDate=1296745441265">camel
with apache feather carrying messages</a></li>

<p>Please provide your feedback on the mailing lists and the irc channel to select a

<h2><a name="SiteUpdateIdeas-SiteGeneration"></a>Site Generation</h2>

<p>The three current ideas for generating the site include:</p>
	<li>sticking with Confluence</li>
	<li>using the CMS under development by the Infrastructure team</li>
	<li>using <a href="" class="external-link" rel="nofollow">Scalate</a></li>

<p>Sticking with Confluence is not a realistic long term solution given the Apache Foundation's
expressed intent to deprecate Confluence for static sites.</p>

<p>The Infrastructure CMS is still an unknown entity and is intended to support a number
of site generation plug-ins. Any solution we choose will need to work with the Infrastructure
publishing system if not directly with the CMS.</p>

<p>Scalate is a powerful and flexible Web framework that allows for a number of mark-up
languages, including Confluence mark-up, as well as number of dynamic Web capabilities. James
Strachan has already started a port of the existing Camel site as a test bed for Scalate.
The project is hosted at Github (<a href="" class="external-link"
rel="nofollow"></a>). To get the code and
build the site do the following:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
git clone https:<span class="code-comment">//
</span>cd camel-docs
mvn jetty:run

<p>ServiceMix is also experimenting with Scalate. There is a sandbox project for a new
ServiceMix Web site based on Scalate that can be checked out using SVN at <a href=""
class="external-link" rel="nofollow"></a>.
To get the code and build the site do the following:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
svn co http:<span class="code-comment">//
</span>cd website20
mvn jetty:run

<p>Gert Vanthienen has started a ServiceMix documentation project using Scalate as well.
It is also hosted at Github (<a href=""
class="external-link" rel="nofollow"></a>.
To get the code and build the site do the following:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
git clone https:<span class="code-comment">//
</span>cd servicemix-documentation
mvn jetty:run

<p>Scalate sites can be viewed by pointing your Web browser to <a href="http://localhost:8080"
class="external-link" rel="nofollow">http://localhost:8080</a>.</p>

<h1><a name="SiteUpdateIdeas-Issues"></a>Issues</h1>

<h2><a name="SiteUpdateIdeas-BarriertoEntryforContributors"></a>Barrier
to Entry for Contributors</h2>

<p>Most of the issues raised revolve around the fact that any solution involving putting
the site under version control, which Infrastructure will begin requiring in 2011, makes it
more difficult for people to contribute to the documentation.</p>

<p>Hadrian raises the issue here: <a href=""
class="external-link" rel="nofollow"></a>.</p>

<p>The current Confluence implementation requires that contributors have a signed CLA
on file before karma can be granted. As Dan K. points out(<a href=""
class="external-link" rel="nofollow"></a>),
the CLA requirement makes the barrier to entry pretty steep already.</p>

<p>Putting the site content in SVN means that contributors will be required to submit
changes as patches through JIRA and explicitly grant license to the ASF for inclusion in the
Camel project. Committers will be required to review and apply the patches. This aligns the
process of contributing documentation with contributing code and requires an extra effort
from the committers.</p>

<p>Using SVN directly changes the nature of the barrier to entry. Opinions vary about
the merits of changing the barrier to entry. Some feel that making people use SVN and JIRA
will scare away some newbies and people who just want to contribute documentation. Others
argue that it is no big deal and that the barrier for making documentation changes should
be the same. </p>

<p>In the long run, this will be a moot point since Infrastructure is going to require
that a project's static site is stored in SVN. A wiki based system such as the Confluence
based one is not ideal for a few reasons. Ideally we should have an SVN based CMS that would
allow a user to edit content online and automate the workflow of submitting the patch. In
principle there is consensus that moving to an SVN based system is the right thing to do.
The question is when to make the change. Should we implement it now, or wait for the availability
of a better CMS?</p>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href=""
class="grey">Change Notification Preferences</a>
        <a href="">View
        <a href="">View
        <a href=";showCommentArea=true#addcomment">Add

View raw message