Hi folks,
Our current website was deployed a loooong time ago and we already
discussed here to make a recast and find a place to put our
documentation.
The related issues could be SHINDIG-283 and SHINDIG-799.
I propose to go ahead with a Maven based site. For those they are
not
aware with this technology, you could always read [1] for more
informations.
Basically, Maven uses inside Doxia which supports several markup
formats:
APT (Almost Plain Text), Confluence, Simplified DocBook, FML (FAQ
Markup Language), FO, iText, LaTeX, RTF, TWiki, XDoc (popular in
Apache land), XHTML
For Eclipse users, M2eclipse plugin [2] has an optional Maven Doxia
editor.
Pros:
* having documentation for a given version (ie 1.0.x 1.1.x) and
storing
in svn
* doc independent on the implementation (ie java PHP)
* reporting
* pdf
Cons:
* deployment need sync (ASF infrastructure)
* potential learning curve on the Doxia formats
Ok but where is the website?
http://people.apache.org/~vsiveton/shindig/
I am inspired by the Opensocial Foundation website.
You will see an (unofficial) Shindig logo. I propose also to have a
Logo Contest to find our logo!
I created some logos (in SVG format) and I plan to create a Wiki
space
for the contest.
http://people.apache.org/~vsiveton/shindig/logo-contest.html
All your comments are welcome!
Cheers,
Vincent
[1] http://maven.apache.org/guides/mini/guide-site.html
[2] http://m2eclipse.codehaus.org/