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