Mailing-List: contact user-help@forrest.apache.org; run by ezmlm
Precedence: bulk
Reply-To: user@forrest.apache.org
Received-SPF: neutral (hermes.apache.org: local policy)
Message-ID: <41DD62F8.7000905@apache.org>
Date: Thu, 06 Jan 2005 16:10:32 +0000
From: Ross Gardler <rgardler@apache.org>
User-Agent: Mozilla Thunderbird 0.9 (Windows/20041103)
To: user@forrest.apache.org
Subject: Re: Error in menus documentation?
References: <833b4fb605010507257b8a2c32@mail.gmail.com>
	 <20050105225227.GB6089@igg.indexgeo.com.au>
	 <833b4fb60501051829ee34aa3@mail.gmail.com>
	 <20050106030431.GB6784@igg.indexgeo.com.au>
 <833b4fb60501060518267aec52@mail.gmail.com>
In-Reply-To: <833b4fb60501060518267aec52@mail.gmail.com>
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Andy J wrote:
> Thanks for the constructive criticism.  Actually, I don't agree with
> that comment (I hope you at least agree that I can disagree with your
> sentiment).  I'm trying to learn Forrest.  Do you think this should
> happen overnight?  Shouldn't there be someplace for a new user to
> turn?
> 
> As a return favor, I'll offer you this suggestion: don't visit the
> "user" mailing list.  Then us "users" (just me at this time but I'm
> assuming they're are more that have been chased away) can learn it the
> old-fashioned way.  In the end, if we haven't walked away in disgust,
> we'll know the internals and what Forrest can do for us.

Andy, I really think you have misinterpreted David's comments here. He 
is simply suggesting that starting to learn Forrest at the beginning, 
with the basic concepts first and then progressing to the advanced 
topics would probably result in a more productive experience on your 
part. This was observed because you appear to be doing some advanced 
customisation of your project before understanding the basic menu 
generation system, you said yourself that you can't create a screenshot 
because you currently don't know "which way is up in Forrest". David is 
merely suggesting that getting a solid understanding of the basic 
Forrest functionality would be a good precursor to creating advanced 
customisations.

I can assure you that his comment was in no way meant as a criticism, he 
even tried to make this clear in his response. As with all email 
communication one needs to think carefully about the real intent of the 
author, there is no "tone of voice" to guide interpretation and there 
can often be language barriers as well. Trust me, the Forrest community 
is one of the most welcoming you will find, and David is one of the most 
constructively helpful readers of this user list.

Lets get on with using and improving Forrest.

Ross

> 
> - Andy 
> 
> On Thu, 6 Jan 2005 14:04:31 +1100, David Crossley <crossley@apache.org> wrote:
> 
>>Andy J wrote:
>>
>>>I'd be happy to contribute in that way (it's one way that I might be
>>>able to help).  As soon as I know which way is up in Forrest!:)
>>
>>This is intended as a constructive comment ...
>>If you don't yet understand how the Forrest internals work,
>>then you should probably not be messing with advanced topics
>>like aggregation and project sitemaps.
>>
>>--David
>>
>>
>>>David Crossley wrote:
>>>
>>>>Andy J wrote:
>>>>
>>>>>If it's not an error, it's at least confusing.  On menus and linking
>>>>>(http://forrest.apache.org/docs/linking.html#menu_generation) the
>>>>>example refers to an image where the How-To Samples is supposed to
>>>>>appear on the Community tab below the About menu item.  This is the
>>>>>case for the second following image but not the image immediately
>>>>>following the example so that seems confusing.  Or am I just not
>>>>>following the example?
>>>>
>>>>It is not an error. It is just that no-one has found the time
>>>>to re-create all the screenshots to update those documents
>>>>to the current default "pelt" skin and recent layout.
>>>>The text of the documents has been updated.
>>>>
>>>>Patches to the documents and updated images are welcome
>>>>via our Jira Issue Tracker.
>>>>
>>>>--David
>>
> 
> 
> 


-- 
No virus found in this outgoing message.
Checked by AVG Anti-Virus.
Version: 7.0.300 / Virus Database: 265.6.8 - Release Date: 03/01/2005