Return-Path: 
 <docs-return-5390-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-docs-archive@httpd.apache.org
Received: (qmail 9206 invoked by uid 500); 28 Jun 2003 14:34:36 -0000
Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:docs-help@httpd.apache.org>
list-unsubscribe: <mailto:docs-unsubscribe@httpd.apache.org>
list-post: <mailto:docs@httpd.apache.org>
Reply-To: docs@httpd.apache.org
Delivered-To: mailing list docs@httpd.apache.org
Received: (qmail 9144 invoked from network); 28 Jun 2003 14:34:35 -0000
X-Epoch: 1056810874
X-Sasl-enc: nFT7IwVu3jUtnQuPJelCHQ
Date: Sat,
 28 Jun 2003 10:34:37 -0400 (=?ISO-8859-1?Q?Est_=28heure_d'=E9t=E9=29?=)
From: Joshua Slive <joshua@slive.ca>
To: docs@httpd.apache.org
Subject: Re: Beginnings of a standards document
In-Reply-To: <20030628135156.L12922@lucid.net.au>
Message-ID: <Pine.WNT.4.55.0306281015530.1476@Poste3947.hec.ca>
References: <20030628135156.L12922@lucid.net.au>
X-X-Sender: slive@www.fastmail.fm
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N


On Sat, 28 Jun 2003, Jason Lingohr wrote:

> I've begun taking on the task of documenting all the drafts/standards that
> Apache adheres to, as per the STATUS file and PR 16938.
>
> Before I march on too much more, I'd like some feedback on roughly how it's
> looking and whatnot.  Content isn't complete, nor is accuracy at this
> point.
>
> http://icarus.apache.org/~jsl/httpd-2.0/manual/relevant_standards.html.en
>
> Opinions welcome, and could someone explain to me the syntax of
> <columnspec><column width=""/> (units used, etc) tag, as I'm not
> seeing those widths get translated into HTML tags.

<columnspec> is presently only used in the LaTeX transform.  The width
units are a fraction of the total line-width.

For your doc, I'd tend to try to avoid tables.  In general, we use tables
as little as possible in the docs, and we use them only for truly tabular
data.  In this doc, I'd probably lean towards using a <dl> or something of
the sort instead of a table.

The other question is does this belong in the manual, or should it be
maintained on the website alone, as it has been in the past:
http://httpd.apache.org/library/

I don't have a strong opinion about that.  In either case, an update is
much needed.

Joshua.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org