Re: [SMARTY-DEV] Smarty docs
| From: | Monte Ohrt | Date: | Mon, 15 Mar 2004 19:13:12 +0000 |
| Subject: | Re: [SMARTY-DEV] Smarty docs | ||
| References: | 1 | Groups: | php.smarty.dev |
| Request: | Send a blank email to php-smarty-dev+get-2202@lists.php.net to get a copy of this message | ||
This looks like a good direction for the docs... anyone else have
comments?
Monte
On Mon, 2004-03-15 at 12:24, Mehdi Achour wrote:
> Hi all !
>
> I'm actually working on the livedocs system
> (http://cvs.php.net/cvs.php/livedocs?login=2).
> Our goal is to make this work with :
> * phpdoc : almost fine
> * peardoc : build is okay, rendering still sucks
> * gtkdoc : steph asked me to work on this later
> * smarty-docs : that's why I'm writing this email :)
>
> I have two questions to ask you :
>
> 1 - are you planing to switch to the same structure and generation
> system as phpdoc ?
> a separated directory for the english documentation, .xml files,
> ./configure and make
> If yes, do you want me to do the work ? (I'd like to)
>
> 2 - are you okay with WS and CS patches ?
> word spacing is actually horrid in smarty docs, with this bad
> indentation, all those tabulations
> I also would like to see smarty's docs rewritten to conform to PEAR
> coding standards in the examples.
> It will also be cool to use a syntax colorization in the examples, but
> this we'll be possible only if you use <programlisting role="php">
> instead of <screen>
>
> I'm ready to put all the mentionned efforts into smarty's documentation,
> the ball is in your camp ;)
>
> thank you for your attention !
>
> Mehdi Achour (didou)