Content-Type: text/plain;
	charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.3\))
Subject: Re: Include PostgresNIO Swift client in the Documentation
From: Daniel Gustafsson <daniel@yesql.se>
In-Reply-To: <182a8337-75e6-8da9-9736-5135f904c525@postgresql.org>
Date: Mon, 21 Aug 2023 13:58:05 +0200
Cc: fabianfett@mac.com,
 pgsql-docs@lists.postgresql.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <FEDC8F5E-F320-45CD-9C66-53B04770793B@yesql.se>
References: <169165415312.635.10247434927885764880@wrigleys.postgresql.org>
 <182a8337-75e6-8da9-9736-5135f904c525@postgresql.org>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Archived-At: 
 <https://www.postgresql.org/message-id/FEDC8F5E-F320-45CD-9C66-53B04770793B%40yesql.se>
Precedence: bulk

> On 11 Aug 2023, at 02:23, Jonathan S. Katz <jkatz@postgresql.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.

--
Daniel Gustafsson