Thread: Redhat Post Installation instructions misleading

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>")?

Thanks,

Jonathan

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.

Thanks,

Jonathan

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

On 10/26/18 4:46 PM, Keith Fiske wrote:
>
> 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.

Thanks for the suggestion, I've pushed up this change.

IMHO I think it would be good to rename "Included in Distribution" in
some way to make it clear there are post-installation instructions
available as well, but I don't have any ideas coming to me at the moment.

Jonathan