MIME-Version: 1.0
In-Reply-To: <152199176304.4544.10483267369608570877@wrigleys.postgresql.org>
References: <152199176304.4544.10483267369608570877@wrigleys.postgresql.org>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Sun, 25 Mar 2018 08:49:53 -0700
Message-ID: 
 <CAKFQuwbS482MzEsGxC0Tc3=bvcy5Q61pfh7-1OhntZD=hq0DMA@mail.gmail.com>
Subject: Re: Getting started guide does not start from first step
To: "matthew.boman@gmail.com" <matthew.boman@gmail.com>,
	"pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Content-Type: multipart/alternative; boundary="001a113fa132c5bda905683e9b77"
Precedence: bulk

--001a113fa132c5bda905683e9b77
Content-Type: text/plain; charset="UTF-8"

On Sunday, March 25, 2018, PG Doc comments form <noreply@postgresql.org>
wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.0/static/tutorial-createdb.html
> Description:


You should learn from the most recent version of the docs, 10.  9.0 is
obsolete.


>
> I'm new to PostgreSQL and following the getting started guide. I expected
> it
> to start from zero, but it assumes the reader already has a database up and
> running and is already connected to it.


There are many different "zero" points - which is touched on in the
"installation" chapter.


>
> 1.3 Creating a database
> I got here and tried the command `createdb mydb`, but it didn't work. I had
> connected to the database (sudo su - postgres) and thought that was the
> only
> step because the command prompt was now `postgre@username`.


su doesn't connect one to the database, it changes the active o/s user.
Not sure about the prompt...

You say it didn't work but I'm suspicious you are mistaken.  The guide says
"If this produces no response then this step was successful and you can
skip over the remainder of this section."

>
> After quite a
> bit of beginner searching on the internet, I found I then had to type
> `psql`
> to actually connect.
>
> It'd be really great for new users if the Getting Started guide was more of
> a walkthrough that contained all the steps--even those little ones of
> getting connected that experienced users overlook.
>

The very next chapter is "accessing a database" ... it's first command is
"psql mydb"

David J.

--001a113fa132c5bda905683e9b77
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<br><br>On Sunday, March 25, 2018, PG Doc comments form &lt;<a href=3D"mail=
to:noreply@postgresql.org">noreply@postgresql.org</a>&gt; wrote:<br><blockq=
uote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc =
solid;padding-left:1ex">The following documentation comment has been logged=
 on the website:<br>
<br>
Page: <a href=3D"https://www.postgresql.org/docs/9.0/static/tutorial-create=
db.html" target=3D"_blank">https://www.postgresql.org/<wbr>docs/9.0/static/=
tutorial-<wbr>createdb.html</a><br>
Description:</blockquote><div><br></div><div>You should learn from the most=
 recent version of the docs, 10. =C2=A09.0 is obsolete.</div><div>=C2=A0</d=
iv><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left=
:1px #ccc solid;padding-left:1ex">
<br>
I&#39;m new to PostgreSQL and following the getting started guide. I expect=
ed it<br>
to start from zero, but it assumes the reader already has a database up and=
<br>
running and is already connected to it.</blockquote><div><br></div><div>The=
re are many different &quot;zero&quot; points - which is touched on in the =
&quot;installation&quot; chapter.</div><div>=C2=A0<br></div><blockquote cla=
ss=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;pa=
dding-left:1ex">
<br>
1.3 Creating a database<br>
I got here and tried the command `createdb mydb`, but it didn&#39;t work. I=
 had<br>
connected to the database (sudo su - postgres) and thought that was the onl=
y<br>
step because the command prompt was now `postgre@username`.=C2=A0</blockquo=
te><div><br></div><div>su doesn&#39;t connect one to the database, it chang=
es the active o/s user.=C2=A0 Not sure about the prompt...</div><div><br></=
div><div>You say it didn&#39;t work but I&#39;m suspicious you are mistaken=
.=C2=A0 The guide says &quot;<span style=3D"font-family:verdana,sans-serif;=
font-size:12.15999984741211px">If this produces no response then this step =
was successful and you can skip over the remainder of this section.&quot;</=
span></div><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;bor=
der-left:1px #ccc solid;padding-left:1ex"><br></blockquote><blockquote clas=
s=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;pad=
ding-left:1ex">After quite a<br>
bit of beginner searching on the internet, I found I then had to type `psql=
`<br>
to actually connect.<br>
<br>
It&#39;d be really great for new users if the Getting Started guide was mor=
e of<br>
a walkthrough that contained all the steps--even those little ones of<br>
getting connected that experienced users overlook.<br>
</blockquote><div><br></div><div>The very next chapter is &quot;accessing a=
 database&quot; ... it&#39;s first command is &quot;psql mydb&quot;</div><d=
iv><br></div><div>David J.</div>

--001a113fa132c5bda905683e9b77--