I saw that there have been a number of starts for getting the project Web
site updated, but not a lot of forward progress. I'd like to help out and
have the time to get some of the work done.

I like the proposal at http://servicemix.apache.org/home2.html. It does a
nice job of presenting a unified entry point and guiding a visitor to the
version of ServiceMix they want. The side menu could be de-cluttered allot.
Perhaps removing the documentation and component sections and adding short
sections for SMX3 and SMX4?

For the version specific sub-sites there needs to be some re-org as well to
make it clear what information is for users and what is for developers. The
SMX4 stuff should probably be re-orged to remove the distictions between the
NMR, Kernel, and ServiceMix.

As for the discussion about moving some of the documentation into DocBook,
or at least into something that can be versioned better, I can help with
that as well. There needs to be some distinction between what should be done
in the Wiki and what should be done in DocBook. IMHO user-facing,
authoritative content should be done in DocBook and technical articles,
knowledge base articles, FAQs, and more developer focused stuff should be
done in the Wiki.

Would it make sense to move the main site pages out of confluence and into a
format that can be stored in SVN? Maybe use a tool like Scalate?
Cheers,
Eric J.

-- 
Principle Technical Writer

Phone (781) 280-4174
Skype finnmccumial
E-Mail emjohn...@fusesource.com
Blog http://documentingit.blogspot.com/

Reply via email to