httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Joshua Slive <>
Subject Converting docs to XHTML (was Re: HTML3.2 -> HTML4.0)
Date Wed, 29 Nov 2000 17:30:52 GMT

On Wed, 29 Nov 2000, James A Sutherland wrote:
> OK. Since I made a start on this a while ago, I'll volunteer to make a start -
> I don't have commit access, though, so who wants to handle the patches? Or can
> I get commit access on docs? Just lowercasing the tags will generate a huge
> flood of trivial but enormous patches; e-mailling them to apache-docs would
> probably put a price on my head :-)
> > It is a significant enough change, that I would probably run it by
> > new-httpd before making any decisions.  We need to make sure that it would
> > not pose a barrier to any of the developers when it comes to documenting
> > their work.
> Agreed; do you want to propose it, or shall I? (If any developers do have
> problems with XHTML, I would be willing to XHTMLify their docs; I doubt this
> will be an issue for many of them, though.)

Okay, here is a suggested course of action:

1. I will give a "heads-up" to the new-httpd list later today
on the XHTML issue to make sure nobody there objects.

2. We wait about two days to make sure eveyone has a chance to
read this thread and voice their opinion on conversion to XHTML.

3. In that time, we settle the issue of what the header and footer SSI
should look like, what it will be called, and how it will be included in
the files and in the distribution.  I think it is time for specific
proposals on this issue, and turn down the bickering a little.  It seems
logical that this be done at the same time as the XHTML conversion.

4. Assuming no objections, and the SSI issue being settled, 
you take one file and convert it and post it.

5. Assuming no objections to this, do the same thing for
an entire directory.  You can tar it up and put it on a website,
or just email it directly to me and I can commit it.  (Or if
you get commit access by this point, you can do it yourself.)

Is this a good plan?


View raw message