Re: documentation update for doc/src/sgml/func.sgml

From: Andreas 'ads' Scherbaum <adsmail(at)wars-nicht(dot)de>
To: pgsql-hackers(at)postgresql(dot)org
Subject: Re: documentation update for doc/src/sgml/func.sgml
Date: 2014-10-17 19:12:46
Message-ID: 54416A2E.2000105@wars-nicht.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 09/14/2014 06:32 PM, Peter Eisentraut wrote:
> On 9/12/14 3:13 PM, Andreas 'ads' Scherbaum wrote:
>> Of course a general rule how to link to WP would be nice ...
>
> I think Wikipedia links should be avoided altogether. We can assume
> that readers are technically proficient to look up general technical
> concepts on their own using a reference system of their choice.
>
> In cases where a link is warranted, it is better to construct a proper
> bibliographic citation to the primary source material, such as an IEEE
> standard or an academic paper, in a way that will stand the test of time.

That's a clear statement, and makes sense. Should be written down
somewhere, so it can be found again.

> Independent of that, it is actually not correct that "we use the IEEE's
> rules", because "we" don't use any rules, that is up to the operating
> system/platform. While most platforms indeed do use the IEEE
> floating-point standard more less, some don't. Section 8.1.3 tries to
> point that out.

New version attached, WP link removed, wording changed.

Regards,

--
Andreas 'ads' Scherbaum
German PostgreSQL User Group
European PostgreSQL User Group - Board of Directors
Volunteer Regional Contact, Germany - PostgreSQL Project

Attachment Content-Type Size
func.sgml.patch text/x-patch 1.2 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Kevin Grittner 2014-10-17 19:17:19 Re: 2014-10 CommitFest
Previous Message Andres Freund 2014-10-17 19:02:51 Re: WIP: dynahash replacement for buffer table