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/
