Sylvain Wallez wrote:
>
> Stefano Mazzocchi wrote:
>
> >People,
> >
> >I know some of you are discouradged by the lack of overall 'polishness'
> >of the latest and greatest version of Cocoon.
> >
> >I think I can speak for the entire development community if I greatly
> >apologize for that. And I think you deserve it.
> >
> >Yes, we are all volunteers, but one way or another, we are earning
> >something from this (if ever, visibility, respect and, last but not
> >least, fun and knowledge) and we must continue the level of the past
> >quality of our work in order to keep things going and to keep things
> >sane.
> >
> >In this regard, I want to tell you a few things that are going on:
> >
> >1) DOCUMENTATION: the documentation has been cleaned up a little, the
> >stylesheets of the web site polished to look much more readable and
> >light. Some documents were removed because we plan to incorporate more
> >stuff into that.
> >
> >In this regard, please, help us making this better!
> >
> >The reason why documentation is normally not that good is that we
> >generally don't need it since we can look into the code (which is the
> >best documentation, if you know where to look) or simply email the guy
> >who wrote it.
> >
> >But this doesn't scale: documentation is the only way to make knowledge
> >scale well.
> >
> >So, if you have *any* kind of notes, mockups, emails-to-your-boss,
> >courses you made to your colleagues, about cocoon and friends, please,
> >let us know! It doesn't matter if they are not formatted properly, if
> >they are not using our Documentation DTD or anything, don't worry, go to
> >bugzilla (http://nagoya.apache.org) and throw it into the PATCH queue,
> >somebody will pick it up, refactor it, place in into the docs and, most
> >important, *give you credits for it*!
> >
> >It's *that* easy, believe me.
> >
> To make things easier for those who want to write with our document DTD,
> I've written a CSS2 stylesheet for it. I tested it with the XMLmind XML
> editor (aka XXE, see http://www.xmlmind.com/xmleditor/) : it's a cool
> open-source CSS2 enabled XML editor written in Java, which provides
> word-processor like document editing.
>
> Since the CSS renders like the web site, writing a doc in the document
> DTD is like writing a web page ! Check it out in
> src/documentation/xdocs/css, and be indulgent since it's my first CSS2
> stylesheet :)
Oh, way cool, I'll check this out right away!
--
Stefano Mazzocchi One must still have chaos in oneself to be
able to give birth to a dancing star.
<[EMAIL PROTECTED]> Friedrich Nietzsche
--------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]
