Re: pg_upgrade doc uses inconsistent versions within the doc.

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: mark(dot)a(dot)sloan(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: pg_upgrade doc uses inconsistent versions within the doc.
Date: 2023-09-26 20:26:05
Message-ID: ZRM+XeYQYZFIKDSn@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Sep 26, 2023 at 10:56:27AM -0700, David G. Johnston wrote:
> On Tue, Sep 26, 2023 at 10:35 AM Bruce Momjian <bruce(at)momjian(dot)us> wrote:
>
> On Mon, Sep 18, 2023 at 08:14:04PM +0000, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> >
> > Page: https://www.postgresql.org/docs/16/pgupgrade.html
> > Description:
> >
> > I feel like for readability the pg_upgrade doc should use the same
> > old_version and new_version examples when showing examples throughout the
> > doc page. 
> >
> > as an exmaple I'm looking at :
> > https://www.postgresql.org/docs/current/pgupgrade.html
> >
> > in some places the example commands use v9.6 and v16. (see step 8)
> >
> > but in other places it mixes versions v9.5 and v9.6 (see step 11 sub step
> 8)
>
> Good point.  I came up with the attached patch.  It uses 9.6 and current
>
>
> I would get rid of any mentions of our old pre-v10 versioning scheme in the
> current documentation.

Good point, how is this attached patch?

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Only you can decide what is important to you.

Attachment Content-Type Size
upgrade_version.diff text/x-diff 3.1 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2023-09-26 21:31:30 Re: group by can use alias from select list
Previous Message Bruce Momjian 2023-09-26 20:14:14 Re: correct documentation in set role