From owner-cvs-all@FreeBSD.ORG  Mon Dec  6 12:03:24 2004
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id D002216A4CE; Mon,  6 Dec 2004 12:03:24 +0000 (GMT)
Received: from aiolos.otenet.gr (aiolos.otenet.gr [195.170.0.23])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 0802B43D66; Mon,  6 Dec 2004 12:03:24 +0000 (GMT)
	(envelope-from keramida@freebsd.org)
Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr
	[62.103.39.226])iB6C3LGP011089;	Mon, 6 Dec 2004 14:03:21 +0200
Received: from orion.daedalusnetworks.priv (orion [127.0.0.1])
	iB6C3KG6001312;	Mon, 6 Dec 2004 14:03:20 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Received: (from keramida@localhost)iB6C3KtC001311;
	Mon, 6 Dec 2004 14:03:20 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Date: Mon, 6 Dec 2004 14:03:20 +0200
From: Giorgos Keramidas <keramida@freebsd.org>
To: Ceri Davies <ceri@submonkey.net>,
	Murray Stokely <murray@freebsd.org>, doc-committers@freebsd.org,
	cvs-doc@freebsd.org, cvs-all@freebsd.org
Message-ID: <20041206120320.GA1224@orion.daedalusnetworks.priv>
References: <200412042304.iB4N488e000350@repoman.freebsd.org>
	<20041206115045.GB513@submonkey.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20041206115045.GB513@submonkey.net>
Subject: Re: cvs commit: www/en/docproj current.sgml
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 06 Dec 2004 12:03:25 -0000

On 2004-12-06 11:50, Ceri Davies <ceri@submonkey.net> wrote:
> On Sat, Dec 04, 2004 at 11:04:08PM +0000, Murray Stokely wrote:
> > murray      2004-12-04 23:04:08 UTC
> >
> >   FreeBSD doc repository
> >
> >   Modified files:
> >     en/docproj           current.sgml
> >   Log:
> >   Use CSS for headings instead of <font> tags.
>
> > | @@ -65,7 +65,7 @@
> > |      the open documentation problem reports.</p>
> > |
> > |      <a name="handbook3"></a>
> > | -    <h3><font color="#660000">FreeBSD Handbook 3rd Edition</font></h3>
> > | +    <h3 class="red">FreeBSD Handbook 3rd Edition</h3>
>
> Hmm.  Does that actually buy us anything in the way of maintainability?

Yes, CSS can buy us a lot in maintainability and consistency.  We just
have to be a bit careful when we use it.  For instance, in this change
the "red" class name should probably go away.  Removing the class and
making all <h3> elements have a standard style with:

	h3 {
		color: maroon;
	}

works too.  It also lets us easily change the default appearance of H3
elements to a more blog-like style later on, without having to remember
what `red' means:

	h3 {
		color: #666;
		margin: 0;
		padding: 2em 0 2px 0;
		border: 0;
		border-bottom: 1px dashed #369;
	}

I am very much in support of using CSS as much as possible for the style
of the pages, if it matters at all.

- Giorgos