Horton

Thread

Commits

  1. doc: Standardize capitalization of term "hot standby"/"Hot Standby"

  1. Changing "Hot Standby" to "hot standby"

    Daniel Westermann (DWE) <daniel.westermann@dbi-services.com> — 2022-03-02T10:16:27Z

    Hi,

with reference to the discussion in docs: https://www.postgresql.org/message-id/flat/2221339.1645896597%40sss.pgh.pa.us#5a346c15ec2edbe8fcc93a1ffc2a7c7d

Here is a patch that changes "Hot Standby" to "hot standby" in high-availability.sgml, so we have a consistent wording.
Thoughts?

There are other places where hot standby is capitalized, but I guess we should start here.

Regards
Daniel

  2. Re: Changing "Hot Standby" to "hot standby"

    Aleksander Alekseev <aleksander@timescale.com> — 2022-03-02T13:44:19Z

    Hi Daniel,

> Here is a patch that changes "Hot Standby" to "hot standby" in
high-availability.sgml, so we have a consistent wording.
> Thoughts?

```
-   <title>Hot Standby Parameter Reference</title>
+   <title>hot standby Parameter Reference</title>
```

Pretty sure that for titles we should keep English capitalization rules.

-- 
Best regards,
Aleksander Alekseev

  3. Re: Changing "Hot Standby" to "hot standby"

    Daniel Westermann (DWE) <daniel.westermann@dbi-services.com> — 2022-03-02T15:22:44Z

    Hi Aleksander,

> Pretty sure that for titles we should keep English capitalization rules.

Done like that. Thanks for taking a look.

Regards
Daniel

  4. Re: Changing "Hot Standby" to "hot standby"

    Kyotaro Horiguchi <horikyota.ntt@gmail.com> — 2022-03-03T01:24:03Z

    At Wed, 2 Mar 2022 15:22:44 +0000, "Daniel Westermann (DWE)" <daniel.westermann@dbi-services.com> wrote in 
> > Pretty sure that for titles we should keep English capitalization rules.
> 
> Done like that. Thanks for taking a look.

    <para>
-    Hot Standby feedback propagates upstream, whatever the cascaded arrangement.
+    hot standby feedback propagates upstream, whatever the cascaded arrangement

    <para>
-    Hot Standby is the term used to describe the ability to connect to
+    hot standby is the term used to describe the ability to connect to


They look like decapitalizing the first word in a sentsnce.

regards.

-- 
Kyotaro Horiguchi
NTT Open Source Software Center

  5. Re: Changing "Hot Standby" to "hot standby"

    Daniel Westermann (DWE) <daniel.westermann@dbi-services.com> — 2022-03-03T06:55:43Z

    Hi Kyotaro,

>>    <para>
>>-    Hot Standby is the term used to describe the ability to connect to
>>+    hot standby is the term used to describe the ability to connect to

>They look like decapitalizing the first word in a sentsnce.

Thanks for having a look. Are you suggesting to change it like this?
-    Hot Standby is the term used to describe the ability to connect to
+    Hot standby is the term used to describe the ability to connect to

Regards
Daniel

  6. Re: Changing "Hot Standby" to "hot standby"

    Kyotaro Horiguchi <horikyota.ntt@gmail.com> — 2022-03-03T07:17:43Z

    At Thu, 3 Mar 2022 06:55:43 +0000, "Daniel Westermann (DWE)" <daniel.westermann@dbi-services.com> wrote in 
> Hi Kyotaro,
> 
> >>    <para>
> >>-    Hot Standby is the term used to describe the ability to connect to
> >>+    hot standby is the term used to describe the ability to connect to
> 
> >They look like decapitalizing the first word in a sentsnce.
> 
> Thanks for having a look. Are you suggesting to change it like this?
> -    Hot Standby is the term used to describe the ability to connect to
> +    Hot standby is the term used to describe the ability to connect to

Yes.  Isn't it the right form of a sentence?

regards.

-- 
Kyotaro Horiguchi
NTT Open Source Software Center

  7. Re: Changing "Hot Standby" to "hot standby"

    Daniel Westermann (DWE) <daniel.westermann@dbi-services.com> — 2022-03-03T07:32:11Z

    >> Thanks for having a look. Are you suggesting to change it like this?
>> -    Hot Standby is the term used to describe the ability to connect to
>> +    Hot standby is the term used to describe the ability to connect to

>Yes.  Isn't it the right form of a sentence?

Done like that.

Regards
Daniel

  8. Re: Changing "Hot Standby" to "hot standby"

    Daniel Westermann (DWE) <daniel.westermann@dbi-services.com> — 2022-03-07T16:06:22Z

    >>> Thanks for having a look. Are you suggesting to change it like this?
>>> -    Hot Standby is the term used to describe the ability to connect to
>>> +    Hot standby is the term used to describe the ability to connect to

>>Yes.  Isn't it the right form of a sentence?

I've created and entry in the Commitfest 2022-07 for this.

Regards
Daniel

  9. Re: Changing "Hot Standby" to "hot standby"

    Robert Treat <rob@xzilla.net> — 2022-03-08T23:30:37Z

    On Mon, Mar 7, 2022 at 11:06 AM Daniel Westermann (DWE)
<daniel.westermann@dbi-services.com> wrote:
>
> >>> Thanks for having a look. Are you suggesting to change it like this?
> >>> -    Hot Standby is the term used to describe the ability to connect to
> >>> +    Hot standby is the term used to describe the ability to connect to
>
> >>Yes.  Isn't it the right form of a sentence?
>
> I've created and entry in the Commitfest 2022-07 for this.
>
I think one more small change...

    A standby server can also be used for read-only queries, in which case
-   it is called a Hot Standby server. See <xref linkend="hot-standby"/> for
+   it is called a hot standby server. See <xref linkend="hot-standby"/> for
    more information.

    A standby server can also be used for read-only queries, in which case
-   it is called a Hot Standby server. See <xref linkend="hot-standby"/> for
+   it is called a <firstterm>hot standby</firstterm> server. See
<xref linkend="hot-standby"/> for
    more information.

Robert Treat
https://xzilla.net

  10. Re: Changing "Hot Standby" to "hot standby"

    Daniel Westermann (DWE) <daniel.westermann@dbi-services.com> — 2022-03-09T07:45:32Z

    >I think one more small change...

>    A standby server can also be used for read-only queries, in which case
>-   it is called a Hot Standby server. See <xref linkend="hot-standby"/> for
>+   it is called a hot standby server. See <xref linkend="hot-standby"/> for
>    more information.

>    A standby server can also be used for read-only queries, in which case
>-   it is called a Hot Standby server. See <xref linkend="hot-standby"/> for
>+   it is called a <firstterm>hot standby</firstterm> server. See
><xref linkend="hot-standby"/> for
>    more information.

Thanks for having a look. Done that way.

Regards
Daniel

  11. Re: Changing "Hot Standby" to "hot standby"

    Michael Paquier <michael@paquier.xyz> — 2022-03-09T08:18:26Z

    On Wed, Mar 09, 2022 at 07:45:32AM +0000, Daniel Westermann (DWE) wrote:
> Thanks for having a look. Done that way.

Hmm.  Outside the title that had better use upper-case characters for
the first letter of each word, I can see references to the pattern you
are trying to eliminate in amcheck.sgml (1), config.sgml (3),
protocol.sgml (3) and mvcc.sgml (1).  Shouldn't you refresh these as
well if the point is to make the full set of docs consistent?

As of the full tree, I can see that:
$ git grep "hot standby" | wc -l
259
$ git grep "Hot Standby" | wc -l
73

So there is a trend for one of the two.
--
Michael