User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0) Gecko/20110812
            Thunderbird/6.0
MIME-Version: 1.0
References: <bs7n95ikt65p$.dlg@nililand.de> <4E5B6BF7.80208@morningstar2.co.uk>
            <CANQYN6w2ZrLzPY4UqJSwFU_A+Vfw=ApeYgPWjg1UVYTv-k-rew@mail.gmail.com>           
            <eab99gnhctiy$.dlg@nililand.de> <4E5BA7FC.8060705@latex-project.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Message-ID:  <4E5BE01C.8030901@morningstar2.co.uk>
Date:         Mon, 29 Aug 2011 19:53:16 +0100
Reply-To: Mailing list for the LaTeX3 project
              <LATEX-L@listserv.uni-heidelberg.de>
Sender: Mailing list for the LaTeX3 project <LATEX-L@listserv.uni-heidelberg.de>
From: Joseph Wright <joseph.wright@MORNINGSTAR2.CO.UK>
Subject: Re: missing or unclear concept documentation
To: LATEX-L@listserv.uni-heidelberg.de
In-Reply-To:  <4E5BA7FC.8060705@latex-project.org>
Precedence: list
Status: R

On 29/08/2011 15:53, Frank Mittelbach wrote:
> Joseph is making quite some effort to improve on the overall
> documentation but we are well aware that documentation of certain
> general concepts is effectively missing or bad and I'm sure some
> concepts we take for granted (having worked with it for quite a while)
> may not at all be obvious to new users

A 'known issue' here is that source3/interface3 is really a 'reference'
guide, and we need a 'learning' guide. Currently, the material in expl3
is a brief overview, but not a guide to learning LaTeX3 programming.

Pointers on specific areas to address are very welcome, as 'write a
better guide' is a bit of a challenge!
-- 
Joseph Wright