Mailing-List: contact dev-help@directmemory.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@directmemory.apache.org
Received-SPF: pass (athena.apache.org: domain of raffaele.p.guidi@gmail.com
 designates 74.125.82.50 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAPoyBqQ75NkeKirC8NoYhSk-mi8iS_bhfgLzrrCcUxa2kxn5gQ@mail.gmail.com>
References: <50708ABF.5090005@apache.org>
	<CAAnVOG0QcKsd5tgV43S+ZEs2tRYrh0c=x31shmLqy+kTxcmv3g@mail.gmail.com>
	<CAAnVOG24ga6tSBp8fQ2vooSZL+uijPXE4JTO6dCujFTS34c_Jw@mail.gmail.com>
	<50709754.6020200@apache.org>
	<CAAqLGLN+xUmzcHJznN76=FXdWCV2ALdbyB3b5nRzDwier=D=og@mail.gmail.com>
	<CAAnVOG0qj7zP=E0PzfM=3Fx_5H+DDFajtQUJxNaCQ7Bv_rO6-g@mail.gmail.com>
	<CAPoyBqQ75NkeKirC8NoYhSk-mi8iS_bhfgLzrrCcUxa2kxn5gQ@mail.gmail.com>
Date: Mon, 8 Oct 2012 15:07:20 +0200
Message-ID: 
 <CAAnVOG0Fmkv5X3q_XBvLHQgTeMsdRSRQUM=BM5LWGbgYf57T_Q@mail.gmail.com>
Subject: Re: Lightning Documentation
From: "Raffaele P. Guidi" <raffaele.p.guidi@gmail.com>
To: dev@directmemory.apache.org
Content-Type: multipart/alternative; boundary=e0cb4e700447d637dc04cb8be67b

--e0cb4e700447d637dc04cb8be67b
Content-Type: text/plain; charset=ISO-8859-1

I agree but docbook and his toolsuite helps organizing ideas in a
consistent reference document (well, a book). That should be differently
organized than the site itself. See spring or hibernate or, if you want to
stay closer to home, apache velocity documentation. They all use docbook
and have great docs (not a cohincidence IMHO).

Regards,
    Raffaele
Il giorno 08/ott/2012 14:09, "Olivier Lamy" <olamy@apache.org> ha scritto:

> could that be integrated in a maven site build ? Is there any maven
> plugin for docbook ?
> Because for javadoc maven is helpfull and well integrated for
> deployment to directmemory.a.o
>
> And IMHO the most important is to write doc (not discussing on the
> tool to do it :P )
>
> 2012/10/8 Raffaele P. Guidi <raffaele.p.guidi@gmail.com>:
> > Yeah I know, I'm proposing a change as I'm not 100% satisfied with it and
> > Docbook really helps in building consistent documentation.
> >
> > What do you think about it?
> >
> > Ciao,
> >     R
> > Il giorno 08/ott/2012 11:35, "Simone Tripodi" <simonetripodi@apache.org>
> ha
> > scritto:
> >
> >> Good morning,
> >>
> >> to publish documentation like the one on
> >> http://directmemory.apache.org/ we used APT and xdoc Maven's format,
> >> not docbook.
> >>
> >> best,
> >> -Simo
> >>
> >> http://people.apache.org/~simonetripodi/
> >> http://simonetripodi.livejournal.com/
> >> http://twitter.com/simonetripodi
> >> http://www.99soft.org/
> >>
> >>
> >> On Sat, Oct 6, 2012 at 10:40 PM, Christoph Engelbert
> >> <noctarius@apache.org> wrote:
> >> > I worked with the docbook standard in a company before. It worked
> >> > very well for documentation of an SOAP webservice and was
> >> > "relatively" easy to customize in terms of layouts.
> >> >
> >> > So +1 from me for using docbook to create pdf and html from the
> >> > docbook standard xml.
> >> >
> >> > I found a really good xml editor with direct docbook support, just
> >> > need to search for it again :-)
> >> >
> >> > Cheers Chris
> >> >
> >> > Am 06.10.2012 22:36, schrieb Raffaele P. Guidi:
> >> >> Yep, it was docbook. I think it brings to extremely well done
> >> >> documentation. Do you guys think that it could be worth giving it a
> try?
> >> >>
> >> >> Ciao,
> >> >>     R
> >> >>
> >> >> On Sat, Oct 6, 2012 at 10:24 PM, Raffaele P. Guidi <
> >> >> raffaele.p.guidi@gmail.com> wrote:
> >> >>
> >> >>> You are welcome, thanks for getting involved :) of course adding
> docs
> >> to
> >> >>> the DM maven site is the preferred way even though I wouldn't say
> that
> >> we
> >> >>> are an excellence, when it comes to docs and probably an easier way
> to
> >> >>> write them would help. Has anyone proposals about it? I really like
> >> how the
> >> >>> spring framework is documented (I think it's done with a lucene
> tool,
> >> don't
> >> >>> remember exactly how it is called and my google karma tonight is
> low).
> >> >>>
> >> >>> Ciao,
> >> >>>     R
> >> >>>
> >> >>>
> >> >>> On Sat, Oct 6, 2012 at 9:47 PM, Christoph Engelbert <
> >> noctarius@apache.org>wrote:
> >> >>>
> >> >>>> Hey guys,
> >> >>>>
> >> >>>> so the account creation was successful :-) Thanks for the given
> >> >>>> trust I'm totally proud.
> >> >>>>
> >> >>>> The first question is how to do documentation for Lightning? Is
> >> >>>> there a preferred way to document subprojects or do they get there
> >> >>>> own part on the main projects page (like it seems to be on the
> >> >>>> commons projects)?
> >> >>>>
> >> >>>> Cheers Chris
> >> >>>>
> >> >>>
> >> >
> >>
>
>
>
> --
> Olivier Lamy
> Talend: http://coders.talend.com
> http://twitter.com/olamy | http://linkedin.com/in/olamy
>

--e0cb4e700447d637dc04cb8be67b--