Re: Lack of detailed documentation - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Lack of detailed documentation
Date
Msg-id CAKFQuwYd-G4o0a79pP8TuCvSYB-4B8ddSvADiEg3MVbKr_iRuA@mail.gmail.com
Whole thread Raw
In response to Lack of detailed documentation  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Lack of detailed documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On Monday, February 10, 2020, Strauss, Randy (ARC-AF)[SGT, INC] <randolph.a.strauss@nasa.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.

pgsql-docs by date:

Previous
From: "Strauss, Randy (ARC-AF)[SGT, INC]"
Date:
Subject: Re: [EXTERNAL] Re: Lack of detailed documentation
Next
From: Tom Lane
Date:
Subject: Re: Lack of detailed documentation