Re: Postgres.js driver - for Node.js

"Jonathan S. Katz" <[email protected]> Wed, 8 Jan 2020 19:45:14 -0500
Newsgroups gmane.comp.db.postgresql.devel.documentation
Message-ID <[email protected]>
This is an OpenPGP/MIME signed message (RFC 4880 and 3156)
--fLw5xA5ctMaRHw5zE96IfwMrkxAcJ7r9j
Content-Type: multipart/mixed; boundary="iKiNkcCdxNDQUuyTdCI9QzqOarCMrSVrJ"

--iKiNkcCdxNDQUuyTdCI9QzqOarCMrSVrJ
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable

On 1/8/20 7:00 PM, Jonathan Buhacoff wrote:
> I'm wondering if the short list in the documentation [2] could be
> replaced with a link to the corresponding wiki page [1] ?

>> [1] https://wiki.postgresql.org/wiki/List_of_drivers#Drivers
>> [2] https://www.postgresql.org/docs/current/external-interfaces.html

IIRC that was one option that was floated. And IIRC there are two
potential issues that arise:

1. While it does easy the administration burden, it's still technically
a validation of drivers in that list. Maybe that's ok, based on what happ=
ens

2. We do ship out documents as PDFs, and said PDFs can be used offline.
If one is trying to understand which drivers are available and they see
a link to it, it may not be terribly helpful :(

That all said, perhaps it's time to update the list in the documentation
and create the guidance in terms of what it takes to have a driver
included in the documentation. I'd be happy to draft up some criteria.

When I last curated the list, I did try to bring it down to specifically
drivers (e.g., not ORMs or tools that enhance PostgreSQL connectivity).

Also, while scanning the list, I also saw that someone recently added
several drivers that appear to be non-OSS. Additionally, a few of the
entries are *not* drivers, which I have gone ahead and removed[1]. I
would say at a minimum, in both the wiki and the docs, we should only
list drivers that are OSS (in particular, so we can actually validate if
they use libpq and support SCRAM), but I will wait until there is some
consensus before removing the other closed-source ones.

Jonathan

[1]
https://wiki.postgresql.org/index.php?title=3DList_of_drivers&diff=3D3455=
4&oldid=3D34553


--iKiNkcCdxNDQUuyTdCI9QzqOarCMrSVrJ--

--fLw5xA5ctMaRHw5zE96IfwMrkxAcJ7r9j
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCAAdFiEE+oS2la8r95ogZD/x8QSccp8cZScFAl4Wd5oACgkQ8QSccp8c
ZSdu+Q//XDheheSvI4Tol8/tCy76+tWzzWpE8IS2GbtEPhGITNgLNbqV9yJZI4KS
yYDxybg8Tq+jfru1MEk7g8HBM0iQ5XWBUR9BSz7YGB4jbghhWzTwNfqf0NRtOIh7
L2gYPOP1v81yPmyYWHIPVm7f0d8xJUC0eyQ3EwN9pmxjWSrFKsLzbvBqwHsdZ5AT
TSkI7i3ViS/SbI+djuUMI+WX5oSvaokauhZAcrLGYgS/VR9cgedojO8jUqlSRHKa
kQOcW9/dVddq1s0axQeAW+E37KWxA6kJ7pstjJoJ0Ff2Xx3ZLszCR4ZREvy3vboX
kH1g88Gddteq4cufh9mFcnwYGc4nizr4uMC3jLHDW7JI8u5YOrDqVkocZMjayP50
vGMqfooRERFfpTJCcmzFZYrIY+G5GHiCw199lHZcnphLRbpRLpnUglg2jBAdZiqd
VScc5dbB4DV+adBxaIP+eXEADMIaggtQAPvv8J0aljm1XOxSyum9BlGrc+i21fia
b5YfjXlokLQpehNKvXBbnABAjypL3Q3Bb1zQBLdVvy9M52bTLPP2358oVV9wL02f
fmPv5sXHG69MoGbiZ3IqTqn/gAk+ivsRDfuznm/gQYIVMZj5KAfTByxIrj+P+Yw4
FNBjbwFOm3ivgJYX0Nc8yY/SOgRREHECNHjdaoc90nxV+kXZfg8=
=yXI3
-----END PGP SIGNATURE-----

--fLw5xA5ctMaRHw5zE96IfwMrkxAcJ7r9j--