public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: Laurenz Albe <[email protected]>
Cc: Liudmila Mantrova <[email protected]>
Cc: [email protected]
Cc: Stephen Frost <[email protected]>
Cc: Sarah Conway Schnurr <[email protected]>
Subject: Re: GSoD - a patch for Getting Started tutorial
Date: Wed, 20 Nov 2019 10:13:50 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <CAEkD-mAxCk_mX_RwjyxBLHEjt_T5-mS-c6ryfh3nBjdbyYMC0g@mail.gmail.com>
	<[email protected]>
	<CAEkD-mD-A1p=xZ7URBM4L5KUap63MQMYh9x1QTTtyFHX+5QcQQ@mail.gmail.com>
	<[email protected]>
	<CAEkD-mB2E90p_hH4qSkxqMQ1KDA_owy3zHz_V3zcwAxZVRKwDA@mail.gmail.com>
	<[email protected]>
	<[email protected]>

Laurenz Albe <[email protected]> writes:
> I kind of like the "troubleshooting" section, but I am unsure where
> to set the limit.  What is there currently doesn't cover all
> potential causes (e.g., connection via TCP, see Windows), but
> being exhaustive is probably impossible and not even desirable.

> On the one hand I can see this section as being helpful for the
> host of people who are having problems connecting, on the other hand
> the true beginner might have trouble understanding explanations
> containing terms like "absolute path" and "Unix-domain sockets".

As far as that goes, Corey's nearby proposal to add a glossary
could be a great help.  We could define such terms there, and
make the tutorial's uses of them be hyperlinks.  So maybe we
should get that done first, and then come back to this?

> (Side remark: I think the spelling should be "UNIX domain sockets".)

FWIW, I think we've used the first spelling in most places.
Which is more "correct", I don't know, but I'm pretty sure
that spelling Unix in all-caps has been out of fashion for
a very long time.

			regards, tom lane

view thread (10+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: GSoD - a patch for Getting Started tutorial
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox