On May 3 Geoffrey Young wrote:

> Stas Bekman wrote:
>
> > Jim Martinez wrote:
> > 
> >> Hi,
> >>
> >> On the perl.apache.org site there is this placeholder:
> >>
> >> http://perl.apache.org/Apache-Test/index.html
> >>
> >> Would it be appropriate to place a link there to this:
> >>
> >> http://perl.apache.org/docs/general/testing/testing.html
> >>
> >> Using the shortcuts navigation, the information light place holder is
> >> always one click away.  The apache testing document doesn't enjoy
> >> such prominent linking and yet it's much more useful that the
> >> placeholder page.
> >>
> >> Perhaps the testing document should replace the place holder
> >> entirely.
> > 
> > 
> > Good idea, Jim.
> > 
> > I'm not sure the current http://perl.apache.org/Apache-Test/ is the
> > right location though. I remember Geoff put it there, so it'll be in
> > the menu, but Apache-Test is not mod_perl, so it should probably leave
> > elsewhere.
> 
> well, perl.apache.org is the parent page for all projects within the
> Apache-Perl TLP, so Apache-Test didn't seem so bad.  
> httpd.apache.org/apreq and httpd.apache.org/test (before we took it
> over) were similar examples of similar circumstances.  but we can create
> a /projects page if you like as well, with /projects/Apache-Test hanging
> off of that.
> 
> > 
> > Should we start perl.apache.org/projects/ or something like that for
> > sub-projects?
> > 
> > Ideas?
> 
> that's fine with me.  the main reason I put that page up was because
> Apache-Test is becoming a relatively complex subproject - it supports
> both perl and php-based tests (both server and command-line) natively
> now, as well as apache C modules, and the plan is to incorporate
> mod_parrot when I have the time.  so, my idea was to have
> Apache-Test/perl, Apache-Test/php, etc for documentation on each
> interface.  but to make that projects/Apache-Test/perl, etc is no big
> deal with me.  I just don't have the free tuits at the moment.
> 
> any chance we can coerce you into leading the effort, jim?  :)

Is this an accurate, acceptable summary of the improvements mentioned
above:

create (as a directory) perl.apache.org/projects/

create (as a directory) perl.apache.org/projects/Apache-Test

create perl.apache.org/projects/index.html which would be a placeholder
like page that links to perl.apache.org/projects/Apache-Test/index.html
(and also possibly to perl.apache.org/projects/Apache-Test/php.html )

move perl.apache.org/docs/general/testing/testing.html to
perl.apache.org/projects/Apache-Test/general.html

If weak documentation is better than no documentation, I'm willing to
create a content light Apache-Test/php page (I recently moved a legacy
will-not-die side project that is written in php to the Apache::Test frame
work).  That page will contain only a few things from slides from the 2004
ApacheCon Apache-Test/PHP talk (three php.ini configuration lines).

So I'd create perl.apache.org/projects/Apache-Test/php.html to hold a few
notes from that Apachecon talk.

If those tasks above are both reasonably complete and acceptable, I'm
willing to do them, if you're asking.

Did I miss anything?

Jim



Reply via email to