Re: documentation update for doc/src/sgml/func.sgml - Mailing list pgsql-hackers

From Andreas 'ads' Scherbaum
Subject Re: documentation update for doc/src/sgml/func.sgml
Date
Msg-id 54416A2E.2000105@wars-nicht.de
Whole thread Raw
In response to Re: documentation update for doc/src/sgml/func.sgml  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: documentation update for doc/src/sgml/func.sgml
List 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

pgsql-hackers by date:

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