+165.  Or thereabouts.

Doxia has a very shallow learning curve.  If you can figure out Guice,
you can figure out APT and XDoc.

-- Adam

On Thu, Mar 26, 2009 at 3:52 PM, Ian Boston <i...@tfd.co.uk> wrote:
> Big +1 :), fantastic, you have done a ton of work there.
> Ian
> On 26 Mar 2009, at 22:02, Vincent Siveton 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/
>
>

Reply via email to