Mailing-List: contact users-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: users@cocoon.apache.org
Message-Id: <s098a2f8.064@cs-emo.csir.co.za>
Date: Wed, 05 May 2004 08:16:36 +0200
From: "Derek Hohls" <DHohls@csir.co.za>
To: <users@cocoon.apache.org>
Subject: Re: Vote: to unify, or not to unify - results
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

Um, at the risk of being labelled a "compromiser", I think
both posts here are saying essentially the same thing - 
keep it simple and direct for folks starting out, but provide 
the links/hooks [carefully labelled, of course!] for those
who want/need/can handle more detail.  The only minor
argument is how much detail to provide the first time aronund,
but this is the type of thing that can be refined over time.

The concept seems simple enough - but are we actually able
to do it??

>>> natz@ya.com 2004/05/04 06:39:40 PM >>>

>Other than the CPA, we would show other options. For example, if a
newbie
>were reading up on JXTemplates, rather than saying that you can use
Jexl or
>JXPath, we would choose our CPA (for example, JXPath), but have a link
to a
>homologous page that explains the same things, but for Jexl. This
would
>reduce one more variable, and thus one more possible source of delay
or
>confusion to a newbie. So new users will be able to get up and running
much
>faster, and once they have more experience, will be able to go over
the
>alternative approaches.
>  
>
    This is just an example of what I think we should avoid... The 
average user does not give a shiling about JXTemplates, JXPath, JEXL or

whatever load of letters we decide to acronymize today.

    The user wants to know how can he set up his ubercool website 
accessing XML documents and SQL data with the mimimum of fuss, and 
hence, the document he is looking for is a step by step guide to do
that.

    In one of those steps, he's shown how to get a needed parameter  
from the context, using our recommended method (JXTemplateTransformer,

through a JXPath expression). There, on a side note, you can have an 
overview on what JXTemplateTranformer is, why is it our preferred
method 
to access the parameter he needs and wich alternatives he could use,
and 
pointers to the wikiPages of the related tecnologies for a deeper study

if he needs it.


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@cocoon.apache.org 
For additional commands, e-mail: users-help@cocoon.apache.org 


-- 
This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.
MailScanner thanks transtec Computers for their support.


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@cocoon.apache.org
For additional commands, e-mail: users-help@cocoon.apache.org