suggested edits for Xaraya_Classic user-main.xt

  Hi all,

What follows is a suggested revision of the paragraph under "A glimpse 
into Xaraya" that is displayed by default when you install Xaraya:

    /Output in Xaraya is controlled by a system of theme templates and
    default templates./  /The content you are currently reading is
    supplied by a theme template located at
    *<installdirectory>/themes/Xaraya_Classic/modules/base/user-main.xt*. 
    The template is part of the Xaraya_Classic theme, which is the
    active theme when you first install Xaraya.  Opening user-main.xt
    with a text editor and editing this content is a good way to get
    started with theming in Xaraya - though you'll soon learn many other
    ways to control the content and presentation of the homepage and
    other pages.
    /

    /Note: Theme templates are sometimes called override templates
    because they override the default templates that come with Xaraya's
    modules.  When you create a theme template, it will always override
    a corresponding default template.  The template you are looking at,
    user-main.xt, overrides the user-main.xd file located at
    *<installdirectory>/modules/base/xartemplates/user-main.xd*.  //

    /

Currently "A glimpse into Xaraya" uses the word "overridden" to describe 
theme templates.  I think that's the wrong word, and may be confusing to 
people, because, in fact, theme templates are not and cannot be 
overridden.  It would be closer to the truth -- though still confusing 
-- to call the xd templates "overridden" templates.  "Override" (as a 
verb) might be accurate as a descriptor for the theme templates, 
although I usually just think of them, and refer to them, as "theme 
templates," myself.

I also think it's confusing to say "The template is part of the /base/ 
module..."  For my part, I do not think of theme templates as being part 
of any module (other than, perhaps, the themes module.)  I think it's 
important to draw a strong distinction between the workings of the 
modules, and the themes that control their output, so I would definitely 
steer clear of saying user-main.xt is "part of the base module."  
Rather, user-main.xd is part of the base module. 

Also, I don't find overridden/internal as easy to understand as 
theme/default.//////

regards,
Ryan

-- 
Ryan Walker
www.WebCommunicate.net:
Insights and resources for effective websites.