public inbox for [email protected]
help / color / mirror / Atom feedFrom: Bruce Momjian <[email protected]>
To: Magnus Hagander <[email protected]>
Cc: Euler Taveira <[email protected]>
Cc: [email protected]
Cc: [email protected]
Subject: Re: Documentation for varbit is missing size parameter
Date: Fri, 30 Mar 2018 12:34:44 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <CABUevEyumGh3r05U3_mhRrEU=dfacdRr2HEw140MvN7FSBMSyw@mail.gmail.com>
References: <[email protected]>
<CAHE3wgg1k5w2M4h6MjSD8tGBVVABiCooXx+VfQaVzwoUAuDFRA@mail.gmail.com>
<[email protected]>
<CABUevEwrn32xWezTNmmUT-7hGcENXRohDYwHnt8MqNm--o0FaA@mail.gmail.com>
<[email protected]>
<CABUevEyumGh3r05U3_mhRrEU=dfacdRr2HEw140MvN7FSBMSyw@mail.gmail.com>
On Fri, Mar 30, 2018 at 06:28:15PM +0200, Magnus Hagander wrote:
> On Fri, Mar 30, 2018 at 6:26 PM, Bruce Momjian <[email protected]> wrote:
> Uh, I am always debating how important it is to backpatck vs the churn
> we require of translations of our docs. In this case, it didn't seem
> worthwhile to have all of those translations try to deal with this
> change for all those back branches.
> If it's a clean backpatch I'd say it is -- people who are using PostgreSQL 9.6
> will be reading the documentation for 9.6 etc, so they will not know about the
> fix then.
>
> If it's not a clean backpatch I can certainly see considering it, but if it's
> not a lot of effort then I'd say it's definitely worth it.
>
> I really don't think considerations for translators of the *docs* are an issue
> here. If you don't backpatch it, then nobody gets the fix. If you backpatch it,
> then English readers do get the fix, and translated docs readers *might* get
> the fix, depending on how they are maintained. It's not like translatable
> strings where if they change in a backbranch they will revert to English unless
> the translation is updated -- for the docs, they just don't get the fix.
My logic is that the more we backpatch, the less likely translators are
going to be to keep their docs up-to-date with minor releases since the
minor release diff is larger and contains more items that aren't
_required_ for correctness.
I looked at this patch and thought it was more a stylistic item rather
than a correction. Is that right?
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +
view thread (10+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
Subject: Re: Documentation for varbit is missing size parameter
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox