Re: Redhat Post Installation instructions misleading

On Wed, Oct 24, 2018 at 7:22 AM Jonathan S. Katz <jkatz(at)postgresql(dot)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