public inbox for [email protected]  
help / color / mirror / Atom feed
Getting started guide does not start from first step
2+ messages / 2 participants
[nested] [flat]

* Getting started guide does not start from first step
@ 2018-03-25 15:29 PG Doc comments form <[email protected]>
  2018-03-25 15:49 ` Re: Getting started guide does not start from first step David G. Johnston <[email protected]>
  0 siblings, 1 reply; 2+ messages in thread

From: PG Doc comments form @ 2018-03-25 15:29 UTC (permalink / raw)
  To: [email protected]; +Cc: [email protected]

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.0/static/tutorial-createdb.html
Description:

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. 

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`. 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.


^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: Getting started guide does not start from first step
  2018-03-25 15:29 Getting started guide does not start from first step PG Doc comments form <[email protected]>
@ 2018-03-25 15:49 ` David G. Johnston <[email protected]>
  0 siblings, 0 replies; 2+ messages in thread

From: David G. Johnston @ 2018-03-25 15:49 UTC (permalink / raw)
  To: [email protected] <[email protected]>; [email protected] <[email protected]>

On Sunday, March 25, 2018, PG Doc comments form <[email protected]>
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.


^ permalink  raw  reply  [nested|flat] 2+ messages in thread


end of thread, other threads:[~2018-03-25 15:49 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-03-25 15:29 Getting started guide does not start from first step PG Doc comments form <[email protected]>
2018-03-25 15:49 ` David G. Johnston <[email protected]>

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