Re: Documenting removal of nonnullvalue() and friends - Mailing list pgsql-docs

From Tom Lane
Subject Re: Documenting removal of nonnullvalue() and friends
Date
Msg-id 5718.1287094063@sss.pgh.pa.us
Whole thread Raw
In response to Re: Documenting removal of nonnullvalue() and friends  (Robert Haas <robertmhaas@gmail.com>)
Responses Re: Documenting removal of nonnullvalue() and friends  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-docs
Robert Haas <robertmhaas@gmail.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

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: [HACKERS] Docs for archive_cleanup_command are poor
Next
From: Robert Haas
Date:
Subject: Re: Documenting removal of nonnullvalue() and friends