From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
Cc: | "Strauss, Randy (ARC-AF)[SGT, INC]" <randolph(dot)a(dot)strauss(at)nasa(dot)gov>, "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 20:43:40 |
Message-ID: | 27125.1581367420@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
"David G. Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> writes:
> 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.
Yeah. Attached is my proposal for clarifying what to do to rotate.
There's a lot more that could be done to improve this page --- for
one thing, most of the other similar tables show the results of the
examples, and for another, it's pretty unclear which data types
each operator takes. But I don't have the time or interest to
tackle a major rewrite, and so far nobody else has stepped up either.
One thing that's sort of blocking any real progress on this is the
draconian space constraints imposed by the tabular format, which is
hurting us on a lot of these pages, not just this one. Alvaro did
some preliminary investigation towards finding a better way [1],
but nobody's tried to push that forward.
regards, tom lane
[1] https://www.postgresql.org/message-id/20200116184444.GA25792%40alvherre.pgsql
Attachment | Content-Type | Size |
---|---|---|
better-geometry-rotation-examples.patch | text/x-diff | 1.1 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2020-02-11 18:37:13 | Duplicating website's formatting in local doc builds |
Previous Message | David G. Johnston | 2020-02-10 19:41:10 | Re: Lack of detailed documentation |