X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (av.hub.org [200.46.204.144])
	by svr1.postgresql.org (Postfix) with ESMTP id 16C76D9B99;
	Wed, 28 Sep 2005 23:30:41 -0300 (ADT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024)
	with ESMTP id 29928-05; Thu, 29 Sep 2005 02:30:33 +0000 (GMT)
Received: from candle.pha.pa.us (candle.pha.pa.us [64.139.89.126])
	by svr1.postgresql.org (Postfix) with ESMTP id 50BC9D9B8B;
	Wed, 28 Sep 2005 23:30:34 -0300 (ADT)
Received: (from pgman@localhost)
	by candle.pha.pa.us (8.11.6/8.11.6) id j8T2Ue812994;
	Wed, 28 Sep 2005 22:30:40 -0400 (EDT)
From: Bruce Momjian <pgman@candle.pha.pa.us>
Message-Id: <200509290230.j8T2Ue812994@candle.pha.pa.us>
Subject: Re: Added documentation about caching, reliability
In-Reply-To: <20050929022349.GB17404@surnet.cl>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
Date: Wed, 28 Sep 2005 22:30:40 -0400 (EDT)
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>
X-Mailer: ELM [version 2.4ME+ PL121 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII
X-Virus-Scanned: by amavisd-new at hub.org
X-Spam-Status: No, hits=0.01 required=5 tests=[AWL=0.010]
X-Spam-Level: 
X-Archive-Number: 200509/50
X-Sequence-Number: 3236

Alvaro Herrera wrote:
> On Wed, Sep 28, 2005 at 10:08:02PM -0400, Bruce Momjian wrote:
> 
> > The chapter sections are:
> > 
> > 	Table of Contents
> > 	26.1. Write-Ahead Logging (WAL)
> > 	26.2. Benefits of WAL
> > 	26.3. WAL Configuration
> > 	26.4. WAL Internals
> > 
> > Are you suggesting we spell out Write-Ahead Logging for all section
> > titles?
> 
> Is it considered good style to use acronyms in titles?  I wouldn't do it.
> 
> Maybe it could be left as
> 
>  	26.1. Write-Ahead Logging
>  	26.2. Benefits of Write-Ahead Logging

I modified 26.2 as you suggested.

>  	26.3. WAL Configuration
>  	26.4. WAL Internals
> 
> because the former two talk about WAL in a general manner, while the
> latter two are about our implementation.  I also wouldn't expand the
> acronym in a title.

I think we do need to show the acronym in the title if use that acronym
in later titles.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073