Re: Plug in docs

From: "Joshua D(dot) Drake" <jd(at)commandprompt(dot)com>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Simon Riggs <simon(at)2ndquadrant(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Plug in docs
Date: 2007-12-16 15:58:50
Message-ID: 47654B3A.7030206@commandprompt.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Bruce Momjian wrote:
> Simon Riggs wrote:
>> Looks like we need some docs on all these new plugin APIs we've
>> introduced in this release.
>>
>> - PL/pgSQL hooks
>> - planner hooks
>> - join order hooks
>
> Do we normally document these? I think these are
> documented-in-the-source-code type issues.

If they are an API they need to be documented. Code is poor (even well
documented code) substitute for good old fashioned docs.

Sincerely,

Joshua D. Drake

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Simon Riggs 2007-12-16 17:40:06 Re: Plug in docs
Previous Message Bruce Momjian 2007-12-16 11:24:48 Re: Dangerous hint in the PostgreSQL manual