Re: Updating the intro for packages - improve usability, reduce newuser confusion - Mailing list pgsql-docs

From Dmitry Igrishin
Subject Re: Updating the intro for packages - improve usability, reduce newuser confusion
Date
Msg-id CAAfz9KO3iYWW=7VfjcrWJ4wUQa56wL666zOOf4R2x8vGmu5_Ew@mail.gmail.com
Whole thread Raw
In response to Re: Updating the intro for packages - improve usability, reduce newuser confusion  (Steve Atkins <steve@blighty.com>)
List pgsql-docs
чт, 29 нояб. 2018 г. в 13:28, Steve Atkins <steve@blighty.com>:
>
>
>
> > On Nov 29, 2018, at 10:17 AM, Steve Atkins <steve@blighty.com> wrote:
> >
> >
> >
> >> On Nov 29, 2018, at 9:36 AM, Christoph Berg <myon@debian.org> wrote:
> >>
> >> Re: Dmitry Igrishin 2018-11-29 <CAAfz9KMcq418B55Hyv2d97Ur+6dhSo_N_u=Dx93d3bMkOPei9A@mail.gmail.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!


pgsql-docs by date:

Previous
From: Steve Atkins
Date:
Subject: Re: Updating the intro for packages - improve usability, reduce newuser confusion
Next
From: Craig Ringer
Date:
Subject: Re: Updating the intro for packages - improve usability, reduce newuser confusion