Mailing-List: contact dev-help@cayenne.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cayenne.apache.org
Received-SPF: pass (athena.apache.org: local policy)
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Apple Message framework v1084)
Subject: Re: Oxygen Licenses (was: Re: Maven: Use of objectstyle.org/maven2
 repository)
From: Andrus Adamchik <andrus@objectstyle.org>
In-Reply-To: <BANLkTinah=Pdcg8r81onhuvurLSOWvN7WA@mail.gmail.com>
Date: Wed, 27 Apr 2011 12:15:52 +0300
Content-Transfer-Encoding: quoted-printable
Message-Id: <597ACDA2-88BF-41AA-8C27-9584E5640BA5@objectstyle.org>
References: <BANLkTinah=Pdcg8r81onhuvurLSOWvN7WA@mail.gmail.com>
To: dev@cayenne.apache.org

I haven't used Docbook, but I've heard good things about it. I feel like =
it will be a good fit for the docs.=20

But what about the website (pages under CAYSITE space in Confluence - =
home page, downloads page, dev guide, announcements blog, etc.)? These =
pages are not "docs" and have different requirements (no need to =
distribute in PDF) and they can benefit from no-delay publishing. So I'd =
give ASF CMS a try for CAYSITE. Maybe we start by migrating this much =
smaller piece to ASF CMS and with that experience in mind make the =
decision about the docs (CAYDOC, CAYDOC30)?

Andrus


On Apr 26, 2011, at 11:11 AM, Christian Grobmeier wrote:

> Hey guys,
>=20
> good news: Oxygen will support Cayenne with free licenses. They just
> need to know how many licenses we need. I now need to know who would
> like to step up. Please give me your full name and your apache id, i
> will then provide a list to the Oxygen guys who will in turn provide
> you the license.
>=20
> Of course we/you should decide first if we really need them :-)
>=20
> Cheers
> Christian
>=20
>=20
> On Tue, Apr 26, 2011 at 8:31 AM, Christian Grobmeier
> <grobmeier@gmail.com> wrote:
>>>> we should start thinking about switching to the new ASF CMS.
>>>=20
>>> I've spent a lot of time over the last year working with docbook and =
am
>>> finding it really rather nice.
>>=20
>> I had a time where I compared Forrest with Docbook and finally found
>> Docbook very interesting myself. It can be generated to plain html =
and
>> one can send patches. This are my strongest requirements. Besides, =
its
>> easily editable and quite easy to learn.
>>=20
>>> rather than crafting it into html around the design.
>>=20
>> This is also true for the CMS.
>>=20
>>> This means, amongst other things, that we can
>>> easily produce pdf/html/etc formats. I have lots of examples if =
people are
>>> interested in seeing it.
>>=20
>> Right this is a very interesting option. As I understood Cayenne is
>> made to be easy for the end customer, a downloadable, complete PDF
>> guide is probably not the badest idea.
>>=20
>>> The main downside, is that all the docs need to be rewritten. And =
that's
>>> lots of lots of work. The best docbook editor available is Oxygen =
Author
>>> (not a free product).
>>=20
>> I have asked the Oxygen guy if they are willing to give out a few
>> licenses to Apache people. Lets see, sometimes they do things like
>> that.
>>=20
>>> I'd be happy to set up the basic structure of the
>>> docs, the build scripts and a few pages. But I'll not have the time =
to
>>> rewrite all the pages. If the consensus is yes to docbook, I am =
happy to get
>>> the first part done.
>>=20
>> If the first part done, I guess the rest comes step by step. My guts
>> say docbook might be a very good choice
>>=20
>> There are also Apache Forrest, Mvn Site, Piwi etc available for such
>> tasks. But I think Docbook is the most stable and powerful tool out
>> there. Mvn site is good, but also very basic.
>>=20
>> Cheers
>>=20
>=20
>=20
>=20
> --=20
> http://www.grobmeier.de
>=20