On Thu, Mar 26, 2009 at 4:29 PM, Dan Peterson <dpeter...@google.com> wrote:
> 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<http://people.apache.org/%7Evsiveton/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) I just added links to partuza and social site to that page. -Lane > > > -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/<http://people.apache.org/%7Evsiveton/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<http://people.apache.org/%7Evsiveton/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/ > > >
