Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@forrest.apache.org
Received-SPF: pass (hermes.apache.org: local policy)
Message-ID: <42709E7C.1010702@uidesign.de>
Date: Thu, 28 Apr 2005 10:27:40 +0200
From: Johannes Schaefer <johannes.schaefer@uidesign.de>
User-Agent: Mozilla Thunderbird 0.9 (Windows/20041103)
MIME-Version: 1.0
To: dev@forrest.apache.org
Subject: Re: describe Forrest in 50 words
References: <20050420025207.GC23861@igg.indexgeo.com.au>
 <87zmvtvhg1.fsf@stat.ufl.edu> <42668D2B.6010501@apache.org>
 <42675A27.2050205@apache.org> <34467517.20050426220941@soethe.net>
 <20050427012943.GA10268@igg.indexgeo.com.au>
 <735723057.20050427085821@soethe.net>
 <20050427073102.GA11603@igg.indexgeo.com.au> <426F43A8.7090307@apache.org>
 <143234017.20050427100321@soethe.net>
 <20050427125034.GA12084@igg.indexgeo.com.au>
In-Reply-To: <20050427125034.GA12084@igg.indexgeo.com.au>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 8bit

Now that David gave the last version,
I'll try to comment ... also dared a look
into the archive.

HERE'S MY TRY:
Apache Forrest is a publishing framework that accepts
various input sources and transforms them into a unified
document collection strictly separating content and
presentation.
It is standards-based, employing Apache Cocoon and
a plugin architecture which makes it modular and
extensible.
Forrest can be used as a dynamic application,
to generate a static result or completely automated.
                                            WORDCOUNT=58


Comments:
* Easier wording. For me as a non-native speaker the prev.
   versions were harder to understand. Shorter sentences.
   (Please correct any errors in my English!)
* Put the main thing up-front: what forrest does. Then
   something about the architecture, then the options.
* I'm not very happy with the last sentence.
* For discussion: "publishing" instead of "documentation"
   framework. This includes web publishing, classic
   documentation (read books, articles), online help etc.
* We might want to spend an extra word, saying "extremely
   modular and extensible".

What do you think?

Johannes


David Crossley wrote:
> Ferdinand Soethe wrote:
> 
>>Ross Gardler wrote:
>>
>>RG> I'd say stick with what we had
>>
>>I agree. No point in having a lengthy discussion. To a large extent it
>>depends on the perspective you have and the background you come from.
>>
>>So if you feel happier with it, just ignore my proposal and
>>stick with the previous text.
> 
> 
> Here is the new version trying to take some of Ferdinand's
> words into account. If no-one has anything more to add or
> change, then i will go ahead and use this.
> 
> Apache Forrest is a standards-based documentation framework
> using a plugin architecture to transform and aggregate various
> input sources into various output formats. It is modular and
> extensible, based on Apache Cocoon, to emphasise the strict
> separation of presentation and content. This creates a unified
> document collection that can be used as a dynamic application,
> or generated at the command-line, or generated and deployed
> with an automated publishing application.
> 
> --David
> 
> 


-- 
User Interface Design GmbH * Teinacher Str. 38 * D-71634 
Ludwigsburg
Fon +49 (0)7141 377 000 * Fax  +49 (0)7141 377 00-99
Gesch�ftsstelle: User Interface Design GmbH * 
Lehrer-G�tz-Weg 11 * D-81825 M�nchen
www.uidesign.de

Buch "User Interface Tuning" von Joachim Machate & Michael 
Burmester
www.user-interface-tuning.de