Modernisation of docs look

[Rodent of Unusual Size <co...@decus.org>]

    I'd like to do some documentation work over the next few weeks.
    I've broken it into numbered pieces described below.  Items [1],
    [3], [5], and [6] might have some objectors; I'll wait a few
    days before starting those to see if anyone squawks.  [2] and [4]
    I'm going to begin immediately.

    BTW, Paul, do you realise that the contributors page claims that you
    "..actually likes documention"?  Does that constitute a
    docu-mention, or is this (and the earlier one) really a typo? ;->

    1. I'd like to make a first pass through all the .html files under
       www.apache.org and do the following:

       o make the background colour white (to match the new front page)
       o centre the "Apache" logo at the top of the page (and the H1 if
         appropriate)

       Both of these should be zero-impact on browsers that don't
       understand the DIV tag, the H1 ALIGN attribute, or the BGCOLOR
       BODY attribute.  Positive impact on the others, which are already
       seeing this on the new front page.

    2. I'd like to address the Martin Kraemer doc fixups.

    3. Next is normalising all the module documentation pages; there
       are some subtle differences from the standard in some of them.

    4. I'm going to finish adding the suspended suggestions/fixes from
       the bugdb to my For-The-Future page.  Would anyone object if I
       merged that into the project-plan document?

    5. Throughout the process, I'd like to have carte blanche to clean
       up the HTML (case-normalisation of tags, indenting, and so on).

    6. Finally, shall I commit my prototype API function dictionary into
       CVS as a starting point?

    Speak up, now..

    #ken    :-)}

Re: Modernisation of docs look

[Marc Slemko <ma...@worldgate.com>]

On Sat, 31 May 1997, Rodent of Unusual Size wrote:

>     1. I'd like to make a first pass through all the .html files under
>        www.apache.org and do the following:
> 
>        o make the background colour white (to match the new front page)

If a background color is set, you better set all the others too.
Otherwise people with their default text color set to white get messed
up...

[...]
> 
>     5. Throughout the process, I'd like to have carte blanche to clean
>        up the HTML (case-normalisation of tags, indenting, and so on).

This gets to be very dangerous.  There is a fine line between cleanup and
person preferences.