Re: Redhat Post Installation instructions misleading

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: Keith Fiske <keith(dot)fiske(at)crunchydata(dot)com>, pgsql-www(at)lists(dot)postgresql(dot)org
Subject: Re: Redhat Post Installation instructions misleading
Date: 2018-10-24 11:21:56
Message-ID: 70ad1ae8-c007-d09e-a353-18000cc83ef6@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

On 10/23/18 2:35 PM, Jonathan S. Katz wrote:
> On 10/23/18 12:59 PM, Jonathan S. Katz wrote:
>> Hi Keith,
>>
>> On 10/22/18 8:23 PM, Keith Fiske wrote:
>>> Ran into an issue trying to help a customer get PostgreSQL running on
>>> CentOS7. 
>>>
>>> /download/linux/redhat/
>>>
>>> Specifically when they got to the Post Installation instructions. The
>>> way the headings are arranged makes this look like a completely distinct
>>> set of instructions when they're in fact specifically only for the
>>> distro provided packages. Had me confused a bit as well since I couldn't
>>> figure out how they got the initialization command without the full path
>>> as well as non-versioned service names. Seems it just needs to be made
>>> more clear that these instructions are ONLY for the distro provided
>>> packages.
>>
>> So if I'm understanding correctly, should we make the "Included in
>> distribution" and "Post-installation" headers both "<h3>" (instead of
>> "<h2>")?
>>
>
> Proposed patch attached. I also debated rearranging the
> "Post-installation" and "Included in distro" sections, but I think to do
> something like that would require more wordsmithing. This should at
> least help with the current readability a bit.

I went ahead and pushed this. Thanks for reporting.

Jonathan

In response to

Responses

Browse pgsql-www by date

  From Date Subject
Next Message Kent Ross 2018-10-24 19:15:15 Versioned documentation search no longer working
Previous Message Jonathan S. Katz 2018-10-23 13:35:12 Re: Redhat Post Installation instructions misleading