Vincent, Thanks for going through this effort. This is a huge improvement! +1 to shipping it ASAP
A couple tiny nits: On the homepage (and the top nav bar): the canonical OpenSocial specs are hosted on OpenSocial.org -- http://www.opensocial.org/page/specs-1 (I'd just link to that top-level page, otherwise we'll have to keep updating links as OpenSocial version evolves) On: http://people.apache.org/~vsiveton/shindig/developers/index.html It might make sense just to point to the Tools and Utilities on wiki.opensocial.org? http://wiki.opensocial.org/index.php?title=Articles_%26_Tutorials#Tools_and_Utilities (though that page should probably also point to partuza and socialsite) -Dan On Thu, Mar 26, 2009 at 3:02 PM, Vincent Siveton <vsive...@apache.org>wrote: > 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/ >
