Re: Updating the intro for packages - improve usability, reduce new user confusion

From: Dmitry Igrishin <dmitigr(at)gmail(dot)com>
To: Steve Atkins <steve(at)blighty(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Updating the intro for packages - improve usability, reduce new user confusion
Date: 2018-11-29 10:45:19
Message-ID: CAAfz9KO3iYWW=7VfjcrWJ4wUQa56wL666zOOf4R2x8vGmu5_Ew@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

чт, 29 нояб. 2018 г. в 13:28, Steve Atkins <steve(at)blighty(dot)com>:
>
>
>
> > On Nov 29, 2018, at 10:17 AM, Steve Atkins <steve(at)blighty(dot)com> wrote:
> >
> >
> >
> >> On Nov 29, 2018, at 9:36 AM, Christoph Berg <myon(at)debian(dot)org> wrote:
> >>
> >> Re: Dmitry Igrishin 2018-11-29 <CAAfz9KMcq418B55Hyv2d97Ur+6dhSo_N_u=Dx93d3bMkOPei9A(at)mail(dot)gmail(dot)com>
> >>>> Could you please add the reference to the Pgfe client library to the
> >>>> documentation?
> >>>> The patch is provided.
> >>
> >>> diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml
> >>> index 347b830..c74e391 100644
> >>> --- a/doc/src/sgml/external-projects.sgml
> >>> +++ b/doc/src/sgml/external-projects.sgml
> >>> @@ -83,6 +83,13 @@
> >>> </row>
> >>>
> >>> <row>
> >>> + <entry>Pgfe</entry>
> >>> + <entry>C++</entry>
> >>> + <entry>An API inspired by libpq</entry>
> >>> + <entry><ulink url="https://github.com/dmitigr/pgfe"></ulink></entry>
> >>
> >> Has that been around long enough, and is widely used, so it qualifies
> >> for mentioning here? I've never heard of it, and it's not packaged for
> >> Debian.
> >
> > No. It's been discussed at least once before that I've noticed, and IIRC
> > the conclusion was "add it to the wiki", which I did in May.
> >
> > https://wiki.postgresql.org/wiki/Client_Libraries
>
> And while it looks like it has the potential to become a decent enough library it's
> own documentation says that it's beta-quality, has an unstable API and isn't
> ready to be used in production.
All these problems are problems of Pgfe, rather than PostgreSQL.
Anyway, let the up to the user to decide what to use and what not. He
or she knows it better.
The problem of PostgreSQL, as this topic suggest, that things related
to PostgreSQL (including client interfaces) "relegates in the dark
corners of notes and appendices". But sometimes the situation is even
worse, because that related things is in the dark corners of Internet
and not even mentioned in the documentation at all!

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Craig Ringer 2018-11-29 13:26:35 Re: Updating the intro for packages - improve usability, reduce new user confusion
Previous Message Steve Atkins 2018-11-29 10:28:35 Re: Updating the intro for packages - improve usability, reduce new user confusion