On Wed, 19 Jun 2002, Stas Bekman wrote:
Currently it has no fit into the mod_perl documentation. I don't see anything in this doc which is already not covered in the docs that I've committed just a few days ago: http://perl.apache.org/release/docs/2.0/user/config/config.html http://perl.apache.org/release/docs/2.0/user/handlers/handlers.html
OK, those ones I had missed. I thought I had been pretty thoroughally through the rest of the site, but these must post-date my reading.
Yup, I've added them a few days ago but forgot to link to them, which I've fixed yesterday.
If you plan to work on something just drop a note saying so, so there will be no wasted work.
All these people who comment in favor of your doc, haven't even seen what we have already and don't know what has been planned.
You're right. They are currently rather hard to find.
Because the new site wasn't released yet. We are still polishing the design (cross-platform/browsers issues). Should be released really soon now.
Rich, what don't you like about the current format? The docs at the URLs I've posted are incomplete but the plan is to have a page of Appendix style where you have all the info placed concisely in one place. e.g. Apache style doc doesn't give you this: http://perl.apache.org/release/docs/2.0/user/config/config.html#mod_perl_Directives_Argument_Types_and_Allowed_Location
No, it is not at all that I don't like the current format. The current format is good. People used to the Apache documentation frequently ask, in my hearing, for a similar document for mod_perl. I have heard this in numerous seminars I have taught and attended. I have seen it on mailing lists and on IRC. This is not saying that one format is bad, but that another is familiar.
mod_perl has a lot of documentation and there will be even more. Our documents are written in POD because mod_perl is distributed on CPAN where all docs are written in POD. By referring to Apache doc format you mean the reference pages, which are just a few (one?) in the mod_perl land. Would you rather see the mod_perl documentation written consistently, or have an odd document which look different in the middle?
But before we do anything in that direction I don't think there is a need for it. Do you think that there is such a need?
I will defer to you on this. I don't want, at any level, to imply that what has been done to date is lacking. This is merely a familiar format that people have asked for, and I was trying to fill a need. I'll back off now on this issue, if there is not general consensus that it is desired. You are right in saying that the new docs fill many of the needs that I am addressing, and the only real different is actual page layout. When can we expect to have these new docs readily accessible from the front page of perl.apache.org?
RSN
I am very interested in being involved in mod_perl documentation in some capacity, but I will lurk for a month or son and see where the need is.
Great, take your time and tune in when you feel ready.
Don't destroy your doc, because mod_perl 1.0 does have this doc (surprise, surprise!):
http://cvs.apache.org/viewcvs.cgi/modperl/htdocs/manual/mod/mod_perl.html
But just as I said, it was last touched 4 years, 3 months ago.
So we probably will supply an Apache style config reference doc with pointers to real docs once those are written.
I wonder if we should create some incoming dir and drop your file there, so it won't get lost. Alternatively post it here, so it'll be archived.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
