Message-ID: <4D96D6B7.2020405@2ndQuadrant.com>
Date: Sat, 02 Apr 2011 09:56:39 +0200
From: Susanne Ebrecht <susanne@2ndQuadrant.com>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US;
	rv:1.9.2.14) Gecko/20110223 Thunderbird/3.1.8
MIME-Version: 1.0
To: Robert Haas <robertmhaas@gmail.com>
CC: pgsql-docs@postgreSQL.org
Subject: Re: refer to books in footnote
References: <4D92E502.9050804@2ndQuadrant.com>
	<4D92E773.7000400@enterprisedb.com>
	<AANLkTimuqRP+=aEKNEoR6cr5Y27CW9XFeT77YCjwUVKL@mail.gmail.com>
In-Reply-To: <AANLkTimuqRP+=aEKNEoR6cr5Y27CW9XFeT77YCjwUVKL@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

On 31.03.2011 18:11, Robert Haas wrote:
> I actually find both phrasings a bit
> ... What we're really trying to do here is provide the
> links, but that is sometimes better done in a footnote or bibliography
> than in the middle of a body of text.
>

Honestly, I like the idea for the  future.
I think the effort doing it in existing docs is too high - but for future
docs it is great.

I have another argument for it:

During translating the tutorial I found another sentence - referring books
for SQL beginners.

After very long thinking and after chatting about it with Peter - I 
skipped the
sentence German translation.

I translate the documentation into German mostly for ppl who are not able
to speak English. It is not a good style to tell people here that when 
they want
to learn SQL they should read English books - besides
there is a translated version of the books - which wasn't the case.

I would not have such a big problem here with translation when links to 
books
would be just in a footnote - it don't look such painful to refer to 
English books in
footnotes, when the books aren't available in German.

Just my 2Cent,

Susanne

-- 
Susanne Ebrecht - 2ndQuadrant
PostgreSQL Development, 24x7 Support, Training and Services
www.2ndQuadrant.com