Re: Redhat Post Installation instructions misleading - Mailing list pgsql-www

From Keith Fiske
Subject Re: Redhat Post Installation instructions misleading
Date
Msg-id CAODZiv5cyL_Cdf1bGXJR8etGhSkUUDmeKUpS-93Ftyg=2xCReg@mail.gmail.com
Whole thread Raw
In response to Re: Redhat Post Installation instructions misleading  ("Jonathan S. Katz" <jkatz@postgresql.org>)
Responses Re: Redhat Post Installation instructions misleading  ("Jonathan S. Katz" <jkatz@postgresql.org>)
List pgsql-www


On Wed, Oct 24, 2018 at 7:22 AM Jonathan S. Katz <jkatz@postgresql.org> wrote:
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. 
>>>
>>> https://www.postgresql.org/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


Sorry, was away from PC for several days.

Ideally the "Post Installation" heading should be a subheading under "Included in distro" since that's what it technically is. So changing "Included in distro" back to match the heading of "PostgreSQL Yum Repository" like it was before would be the ideal fix. As things are now, it looks like "Included in Distro" is a subheading under the PGDG Repo instructions.


--
Keith Fiske
Senior Database Engineer
Crunchy Data - http://crunchydata.com

pgsql-www by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: Versioned documentation search no longer working
Next
From: Fabrice
Date:
Subject: Wiki editor request