[albatross-users] al-for and Template frustration and confusion

[Matt Goodall]

On Sun, 2003-06-29 at 10:42, Dave Cole wrote:
> I am at the end of the largest outstanding documentation task - the
> tag reference.  Now would be a good time to hit me with issues before
> I launch into another task.

The new tag reference looks really good. For me, there's enough detail
in there without it getting too verbose and, as I have previously
mentioned, I particularly like the way each attribute has its own
section.

Since I couldn't see much to comment on in the tag ref I started reading
from the beginning instead. Here's some comments up to the end of
section 3 (which I realise I have never read properly before!) ...

Introduction
~~~~~~~~~~~~
I think the following are either missing or not specifically listed:
 - simple and flexible to use (as opposed to the framework itself)
 - lightweight enough for cgi
 - controller to route a request to the correct handler
 - custom tags (jsp-like but simple to use)
 - form population and parsing

Front Matter
~~~~~~~~~~~~
Add a "See Also" link to www.fastcgi.com and maybe python.org

3.5.3 Multiple Argument Macros
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This could probably do with a small example anyway.


-- 
Matt Goodall, Pollenation Internet Ltd
w: http://www.pollenation.net
e: matt at pollenation.net