[Doc] Improve hostssl related descriptions and option presentation

Started by David G. Johnstonabout 2 years ago5 messageshackers
Jump to latest
#1David G. Johnston
david.g.johnston@gmail.com

Motivated by a recent complaint [1]/messages/by-id/170672433664.663.11895343120533141715@wrigleys.postgresql.org I found the hostssl related material in
our docs quite verbose and even repetitive. Some of that is normal since
we have both an overview/walk-through section as well as a reference
section. But the overview in particular was self-repetitive. Here is a
first pass at some improvements. The commit message contains both the
intent of the patch and some thoughts/questions still being considered.

David J.

[1]: /messages/by-id/170672433664.663.11895343120533141715@wrigleys.postgresql.org
/messages/by-id/170672433664.663.11895343120533141715@wrigleys.postgresql.org

Attachments:

v1-0001-docs-improve-hostssl-related-descriptions-and-option.patchtext/x-patch; charset=US-ASCII; name=v1-0001-docs-improve-hostssl-related-descriptions-and-option.patchDownload+92-102
#2David G. Johnston
david.g.johnston@gmail.com
In reply to: David G. Johnston (#1)
Re: [Doc] Improve hostssl related descriptions and option presentation

Thoughts anyone?

On Thu, Feb 1, 2024 at 3:47 PM David G. Johnston <david.g.johnston@gmail.com>
wrote:

Show quoted text

Motivated by a recent complaint [1] I found the hostssl related material
in our docs quite verbose and even repetitive. Some of that is normal
since we have both an overview/walk-through section as well as a reference
section. But the overview in particular was self-repetitive. Here is a
first pass at some improvements. The commit message contains both the
intent of the patch and some thoughts/questions still being considered.

David J.

[1]
/messages/by-id/170672433664.663.11895343120533141715@wrigleys.postgresql.org

#3David G. Johnston
david.g.johnston@gmail.com
In reply to: David G. Johnston (#2)
Re: [Doc] Improve hostssl related descriptions and option presentation

On Mon, Apr 22, 2024 at 2:20 PM David G. Johnston <
david.g.johnston@gmail.com> wrote:

Thoughts anyone?

On Thu, Feb 1, 2024 at 3:47 PM David G. Johnston <
david.g.johnston@gmail.com> wrote:

Motivated by a recent complaint [1] I found the hostssl related material
in our docs quite verbose and even repetitive. Some of that is normal
since we have both an overview/walk-through section as well as a reference
section. But the overview in particular was self-repetitive. Here is a
first pass at some improvements. The commit message contains both the
intent of the patch and some thoughts/questions still being considered.

David J.

[1]
/messages/by-id/170672433664.663.11895343120533141715@wrigleys.postgresql.org

Withdrawn as this now has conflicts from recent changes and no one seems
interested in voicing an opinion on this for or against.

David J.

#4vignesh C
vignesh21@gmail.com
In reply to: David G. Johnston (#3)
Re: [Doc] Improve hostssl related descriptions and option presentation

On Fri, 28 Feb 2025 at 00:08, David G. Johnston
<david.g.johnston@gmail.com> wrote:

On Mon, Apr 22, 2024 at 2:20 PM David G. Johnston <david.g.johnston@gmail.com> wrote:

Thoughts anyone?

On Thu, Feb 1, 2024 at 3:47 PM David G. Johnston <david.g.johnston@gmail.com> wrote:

Motivated by a recent complaint [1] I found the hostssl related material in our docs quite verbose and even repetitive. Some of that is normal since we have both an overview/walk-through section as well as a reference section. But the overview in particular was self-repetitive. Here is a first pass at some improvements. The commit message contains both the intent of the patch and some thoughts/questions still being considered.

David J.

[1] /messages/by-id/170672433664.663.11895343120533141715@wrigleys.postgresql.org

Withdrawn as this now has conflicts from recent changes and no one seems interested in voicing an opinion on this for or against.

I've updated the commitfest entry status to "withdrawn." Feel free to
add it again anytime if you change your mind.

Regards,
Vignesh

#5David G. Johnston
david.g.johnston@gmail.com
In reply to: vignesh C (#4)
Re: [Doc] Improve hostssl related descriptions and option presentation

On Sunday, March 9, 2025, vignesh C <vignesh21@gmail.com> wrote:

On Fri, 28 Feb 2025 at 00:08, David G. Johnston
<david.g.johnston@gmail.com> wrote:

On Mon, Apr 22, 2024 at 2:20 PM David G. Johnston <

david.g.johnston@gmail.com> wrote:

Thoughts anyone?

On Thu, Feb 1, 2024 at 3:47 PM David G. Johnston <

david.g.johnston@gmail.com> wrote:

Motivated by a recent complaint [1] I found the hostssl related

material in our docs quite verbose and even repetitive. Some of that is
normal since we have both an overview/walk-through section as well as a
reference section. But the overview in particular was self-repetitive.
Here is a first pass at some improvements. The commit message contains
both the intent of the patch and some thoughts/questions still being
considered.

David J.

[1] /messages/by-id/170672433664.663.

11895343120533141715%40wrigleys.postgresql.org

Withdrawn as this now has conflicts from recent changes and no one seems

interested in voicing an opinion on this for or against.

I've updated the commitfest entry status to "withdrawn." Feel free to
add it again anytime if you change your mind.

Thanks. Apparently I ended up with two CF entries for this and I only
withdrew one of them.

David J.