Re: Documenting removal of nonnullvalue() and friends

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, Josh Kupershmidt <schmiddy(at)gmail(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: 2010-10-14 22:07:43
Message-ID: 5718.1287094063@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Robert Haas <robertmhaas(at)gmail(dot)com> writes:
> I find the idea of things being intentionally undocumented quite
> difficult. How is someone coming along supposed to know which things
> are intentionally undocumented and which things are unintentionally
> undocumented?

They should assume the lack of documentation is intentional. Six or
seven years ago your argument might have held some water, but we've
been quite rigorous about requiring externally-visible features to be
documented from the get-go.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Robert Haas 2010-10-14 23:04:56 Re: Documenting removal of nonnullvalue() and friends
Previous Message Tom Lane 2010-10-14 22:05:48 Re: [HACKERS] Docs for archive_cleanup_command are poor