public inbox for [email protected]  
help / color / mirror / Atom feed
From: Alvaro Herrera <[email protected]>
To: Bruce Momjian <[email protected]>
Cc: PostgreSQL-development <[email protected]>
Cc: PostgreSQL-documentation <[email protected]>
Subject: Re: Added documentation about caching, reliability
Date: Wed, 28 Sep 2005 22:23:49 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

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
 	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.

-- 
Alvaro Herrera       Valdivia, Chile   ICBM: S 39º 49' 17.7", W 73º 14' 26.8"
Thou shalt study thy libraries and strive not to reinvent them without
cause, that thy code may be short and readable and thy days pleasant
and productive. (7th Commandment for C Programmers)



view thread (16+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: Added documentation about caching, reliability
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox