Re: Lack of detailed documentation

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: "Strauss, Randy (ARC-AF)[SGT, INC]" <randolph(dot)a(dot)strauss(at)nasa(dot)gov>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Lack of detailed documentation
Date: 2020-02-10 19:41:10
Message-ID: CAKFQuwYd-G4o0a79pP8TuCvSYB-4B8ddSvADiEg3MVbKr_iRuA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Monday, February 10, 2020, Strauss, Randy (ARC-AF)[SGT, INC] <
randolph(dot)a(dot)strauss(at)nasa(dot)gov> wrote:

> Yes, I figured this out. People shouldn't have to figure out that the 2
> numbers in the vector are the scale and rotation.
> They could be the rotation and scale. The rotation could be in degrees or
> radians.
> This is documentation- it should explain it.
> And yes, does it rotate around its center, or the origin?
> And this was just one example. Every friggin' one of them needs to be
> documented.
> I'm not demanding that they be done right away, but there should be a
> description of each. They can all start with TBD...
>

I doubt anyone disagrees with the sentiment but the last time the lack of
documentation was brought up here was years ago and no one stepped up then
to volunteer their time to improve this lesser used area of the database
and it doesn’t seem likely to happen organically here either as this
message seems to imply a lack of interest in being part of the solution.

David J.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2020-02-10 20:43:40 Re: Lack of detailed documentation
Previous Message Strauss, Randy (ARC-AF)[SGT, INC] 2020-02-10 18:39:52 Re: [EXTERNAL] Re: Lack of detailed documentation