I've not used DocBook, either. I've glanced at it a few times, but that is the extent of my knowledge. One thing I do find especially interesting about DocBook is the ability to create HTML, PDF, and EPUB documents from it. That would allow easy targeting of e-readers (Kindle, iPad, iPhone, Android, Nook, Sony Reader, Kobo, ...)
I've not kept up on ASF CMS, either, but I've read just a little about it and am not sure it is the way to go yet. I'm open to being re-educated, of course. :-) In general, though, I think this needs to be well thought-out. Thanks, mrg On Wed, Apr 27, 2011 at 5:15 AM, Andrus Adamchik <[email protected]> wrote: > 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. > > 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, >> >> 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. >> >> Of course we/you should decide first if we really need them :-) >> >> Cheers >> Christian >> >> >> On Tue, Apr 26, 2011 at 8:31 AM, Christian Grobmeier >> <[email protected]> wrote: >>>>> we should start thinking about switching to the new ASF CMS. >>>> >>>> I've spent a lot of time over the last year working with docbook and am >>>> finding it really rather nice. >>> >>> 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. >>> >>>> rather than crafting it into html around the design. >>> >>> This is also true for the CMS. >>> >>>> 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. >>> >>> 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. >>> >>>> 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). >>> >>> 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. >>> >>>> 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. >>> >>> If the first part done, I guess the rest comes step by step. My guts >>> say docbook might be a very good choice >>> >>> 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. >>> >>> Cheers >>> >> >> >> >> -- >> http://www.grobmeier.de >> > >
