Re: [SMARTY] the manual
| From: | Peter Bowyer | Date: | Mon, 03 Jun 2002 15:24:41 +0000 |
| Subject: | Re: [SMARTY] the manual | ||
| References: | 1 | Groups: | php.smarty.general |
| Request: | Send a blank email to php-smarty-general+get-4534@lists.php.net to get a copy of this message | ||
At 10:14 03/06/02 -0500, Monte Ohrt wrote:
The manual is written in SGML and rendered to HTML with dsssl using dbtools like so:Do you have any good references for learning the PHP documentation language/SGML? I'm supposed to be writing docs for a class in PEAR but cannot figure out how to do it :-)
The current manual is kind of a mix and match between a reference manual and a user guide, leaning more toward a reference manual. I've been wanting to put together a comprehensive user guide, but haven't had any time to start such a project. It should not only cover how Smarty works, but more importantly _how_ to write applications using Smarty.An important point. And all code should be reviewed by at least 3 people before being added to the manual, to prevent it becoming like so many of the PHP books available - full of crap code that won't work with register_globals=Off and mixes coding standards.
Such material would be more than enough to write an entire book (which is not a bad idea IMHO.) FYI, the latest "PHP in 24 hours" book covers Smarty in an entire chapter by itself!Do you think they'd allow you to reproduce this one chapter on the Smarty web site? It would be a great advertisement for the book... Peter -- Maple Design - quality web design and programming http://www.mapledesign.co.uk