Stas Bekman wrote:
> I was also thinking that it'd be nice to cut the pod files from A-T's
> .pm files, just like we do with mod_perl. Host those in the modperl-docs
> repository and extract those via svn into Apache-Test/docs/ which
> consequently gets glued to .pm files on install. That way online docs
> will be complete.
> 
> In which case it probably makes sense to follow the same layout as mp
> docs, i.e.:
> 
> Apache-Test/api/  <= Apache::Test, Apache::TestRequest, etc.
> Apache-Test/user/ <= tutorials and stuff
> 
> The user/ will probably split into perl/, php/, python/, etc, with
> language specific docs living under those dirs.

+1

> 
> I suppose that the client side will be always be in perl, right?

nope :) as of 1.21 you can write t/foo.php and it will DTRT.  so long as
t/TEST uses Apache::TestRunPHP, that is.

> 
> so may be it should be /server/ instead of /user/?

nah, I like /user better.  so, let /api be the docs for the various A-T
classes, and /user/$lang be for language/apache-module specific configs,
docs, etc.

--Geoff

Reply via email to