Re: dot dot dot dot - Mailing list pgsql-docs

From Jean-Louis GUENEGO
Subject Re: dot dot dot dot
Date
Msg-id CAH9UnJkuhEvyNdx6Sc2gwqeg6-M2wA=ZiEb1PQHD04koKF_C7Q@mail.gmail.com
Whole thread Raw
In response to Re: dot dot dot dot  (Jürgen Purtz <juergen@purtz.de>)
List pgsql-docs
Hi Jürgen,

ok if you say so. But as "...." may be understood as "../.." with a forgotten slash, I would suggest to choose for instance "<...>" which is best known and understood to be replaced by whatever.

And another thing more general, the tutorial suggest to compile something with "make" the tutorial. I think for people on Windows (they are a lot) who has not the "make" command, this is blocking. And more than that : they just have installed the binary install, and inside it, there is no "tutorial". So they have to git clone the source... which require more dev skill that normally required for a postgresql tuto.

And after that they get a lesser good opinion about what is postgresql (because of poor User experience when learning basic).

I would suggest to deliver directly some sql scripts that don't need compilation.

Kind regards,
Jean-Louis

On Wed, May 13, 2020 at 9:19 PM Jürgen Purtz <juergen@purtz.de> wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/12/tutorial-sql-intro.html
> Description:
>
> .... is wrong.

The four dots are not really a part of the path. Don't use them
literally. They indicate that you should use your local path instead.
This may differ from installation to installation.

Kind regards, Jürgen




--
Jean-Louis GUENEGO
Tel : +33 6 12 19 81 48
mail: jlguenego@gmail.com

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Another modest proposal for docs formatting: catalog descriptions
Next
From: Daniel Gustafsson
Date:
Subject: Re: TLS docs fixes for