Hi, Jason.

I think your idea is useful and we it need be realized.

What other people think?

Anton

On Thu, May 29, 2008 at 10:25 PM, Jason - USL <[EMAIL PROTECTED]>
wrote:

> Hi, everybody.
>
> I'm wondering if anybody's created or thought about a system for
> documenting the PHPTAL templates themselves. It seems to me that, for a
> project of any size, it would be ideal if each template could be
> processed by a documentation engine that tells the developers which
> variables/objects/arrays need to be passed into the template and how
> they're used.
>
> For example, if my template designer creates something like
> tal:repeat="option options", my php developer would see a corresponding
> line in the documentation saying that the variable 'options' needs to be
> set, and it needs to implement the iterable interface...
>
> I though maybe it could be achieved by hacking together some custom
> objects to use in place of the standard PHPTAL_Php_CodeGenerator and
> PHPTAL_Php_CodeWriter to generate documentation instead of compiled
> template files.
>
> After getting into the code, though, it looks like a bigger project than
> I'd thought. So, I was wondering if anybody on the list has done
> something like this, or has better ideas for communicating and
> documenting the templates' functions.
>
> Thanks for any advice you can give,
>
> Jason
>
>
>
>
> _______________________________________________
> PHPTAL mailing list
> PHPTAL@lists.motion-twin.com
> http://lists.motion-twin.com/mailman/listinfo/phptal
>
_______________________________________________
PHPTAL mailing list
PHPTAL@lists.motion-twin.com
http://lists.motion-twin.com/mailman/listinfo/phptal

Reply via email to