Mailing-List: contact chemistry-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: chemistry-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of jhuebel@opentext.com designates
 149.235.128.48 as permitted sender)
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
Subject: RE: Chemistry documentation page
Date: Fri, 12 Feb 2010 13:05:18 +0100
Message-ID: <267F7EC9C11CCB4C806D30029DA677630E17C705@MUCXGC2.opentext.net>
In-Reply-To: <81BAE687-9A00-4BF5-B156-E10E4FD6862D@gmail.com>
Thread-Topic: Chemistry documentation page
Thread-Index: AcqrwCZArF2CG6rnQ6anz2X+tUUlkQAGoMLg
References: <267F7EC9C11CCB4C806D30029DA677630E17C62E@MUCXGC2.opentext.net>
 <81BAE687-9A00-4BF5-B156-E10E4FD6862D@gmail.com>
From: =?iso-8859-1?Q?Jens_H=FCbel?= <jhuebel@opentext.com>
To: <chemistry-dev@incubator.apache.org>

Hi Gabriele,

thanks for this fast feedback. Actually we started with maven site but =
transferred our stuff to Confluence. The mvn site seems not to be very =
convenient for larger documentation work. Each typo fix needs a complete =
recompilation for seeing what you have written. You also need svn access =
for fixes. Confluence offers more comfort and better tooling imho. =
Personally I would appreciate if the barrier to provide useful =
documentation is not too high.

Are there any guidelines how Apache projects use these tools and what =
belongs where? Are there any plans how the others want to make use of =
it?

Thanks Jens


-----Original Message-----
From: Gabriele Columbro [mailto:columbro@gmail.com]=20
Sent: Freitag, 12. Februar 2010 09:48
To: chemistry-dev@incubator.apache.org
Subject: Re: Chemistry documentation page

Hi Jens,
I see the wiki actually as more developers/design documentation while =20
I see the comprehensive and structured documentation as perfect fit =20
for the Maven site capabilities.

That would automatically generate a default documentation site (with =20
selected reports) per every module + every custom documentation page =20
you write in the src/site folder of that module.

What do also the others think?

Ciao!
Gab

On Feb 12, 2010, at 8:50 AM, Jens H=FCbel wrote:

> Hi,
>
>
>
> we have started putting some documentation about OpenCMIS in the =20
> Confluence wiki (http://cwiki.apache.org/CMIS/opencmis.html). With =20
> the increasing community and the recent contributions the Chemistry =20
> structure gets more complex. I think we need an overview page and =20
> sub-sections for the sub projects. We also should provide a =20
> description how the sub projects depend on each other or where they =20
> are independent.
>
>
>
> Are there any proposals out there how to design the project =20
> navigation?
>
>
>
> Jens
>
>
>

--=20

Eng. Gabriele Columbro
Alfresco Software, Ltd.

M: +31 (0)627 565 103
P: +39 320 161 28 46
D: +44 (0)1628 876 654
Skype: gabrielecolumbro
Blog: http://www.mindthegab.com