Re: Include PostgresNIO Swift client in the Documentation

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: fabianfett(at)mac(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Include PostgresNIO Swift client in the Documentation
Date: 2023-08-21 14:55:51
Message-ID: 82c08afc-6d41-7766-b3ac-755ac4ac78f4@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 8/21/23 7:58 AM, Daniel Gustafsson wrote:
>> On 11 Aug 2023, at 02:23, Jonathan S. Katz <jkatz(at)postgresql(dot)org> wrote:
>
>> The last time this came up, I think we discussed linking to the wiki page from the docs, vs. trying to keep the docs up-to-date with all of the drivers available. Perhaps it's worth seeing if we want to make any changes to the docs page prior to the v16 GA?
>
> The docs page does mention that the list is likely to be incomplete, with the
> following sentence, but there is no mention of the Wiki page at all:
>
> "Table H.1 includes a list of some of these projects."
>
> That being said, a lot of readers will likely skim over and immediately look at
> the table, missing the small disclaimer. I wonder if we aren't serving our
> users better by removing the table and only referring to the Wiki page? Having
> two lists will prompt the discussion of what to include where over and over
> again, which isn't helping anyone.

This is what I was saying. I was waiting on attempting a patch to see if
there was consensus. There's now a couple of threads now with similar
suggestions, I'll work on getting patches ready.

Thanks,

Jonathan

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2023-08-21 18:10:33 Create Role Documentation - Not Clear for new users
Previous Message Daniel Gustafsson 2023-08-21 12:24:53 Re: In docs there is no "Installation from Binaries" section