Smarty docs
| From: | Mehdi Achour | Date: | Mon, 15 Mar 2004 18:24:31 +0000 |
| Subject: | Smarty docs | ||
| Groups: | php.smarty.dev | ||
| Request: | Send a blank email to php-smarty-dev+get-2201@lists.php.net to get a copy of this message | ||
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)