MIME-Version: 1.0
Date: Mon, 6 Jan 2014 08:18:42 -0800
Message-ID: 
 <CA+94MuaJTHjqrffz-wiuyF56r=nGG1GC96CTG_Gou5j7Vno_YA@mail.gmail.com>
Subject: pgAmin III 1.18.0 docs.
From: Barry Gysbers <barrygysbers@gmail.com>
To: pgsql-docs@postgresql.org
Content-Type: multipart/alternative; boundary=047d7bf109fefd170304ef4f9cf7
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

--047d7bf109fefd170304ef4f9cf7
Content-Type: text/plain; charset=ISO-8859-1

2014Jan07 07:56

Greetings!

I am an experienced database user/programmer.  I am absolutely brand new to
PostgreSQL.  I just downloaded 9.3.0 on 2013Oct01 and am finally getting
over my reluctance to learn a new system and taking a look at it.  The file
was

postgresql-9.3.0-1-windows.exe

and this email refers to the documentation that came with that package.

I started reading the documentation today for pgAdmin III 1.18.0 as it
seems that I must use pgAdmin III in order to get any work done.  I have
only read about a dozen pages before becoming overloaded.  With the
exception of changing the passworld, I have no idea what I read means, nor
the significance of any of it.  I would think that it would be more helpful
to either explain what you are expected to already know before being able
to use the documentation, or, (more skillfully), put links that explain
what each technical term means, and/or what relevance/consequence each
decision you make has.

Otherwise, I have no idea when or where I will ever run into that
particular jargon ever again, and the wondrous possibility that context
will suddenly make things clear that were obscure the first time around.

Mostly, I just wanted to point out that there are an absolutely incredible
number of typos on the very few pages that I have slogged through so far.
It is clear that nobody has read this documentation in ages, as it would be
impossible for any alert human being to miss them.  I imagine that most of
them are a result of prior editing, and that the final result might
actually be better than the previous version of the documentation, but
there can be no excuse for failing to run any prepared text through a spell
checker, which would catch a large number of the typos.

I would be happy to provide at least some editing services as my
contribution to the project, (being absolutely ignorant of anything
actually useful), provided there was some guarantee that they would
actually be implemented or otherwise used.

I would have to be told exactly how to go about making changes in a way
that would be considered useful.  I am guessing that merely submitting a
list of the text with typos and providing my suggested corrections would
likely not be input, as this work is very boring for most people.

Thanks for your consideration,

Barry Gysbers

--047d7bf109fefd170304ef4f9cf7
Content-Type: text/html; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

<div>2014Jan07 07:56</div>
<div>=A0</div>
<div>Greetings!</div>
<div>=A0</div>
<div>I am an experienced database user/programmer.=A0 I am absolutely brand=
 new to PostgreSQL.=A0 I just downloaded 9.3.0 on 2013Oct01 and am finally =
getting over my=A0reluctance to learn a new system and=A0taking a look at i=
t.=A0 The file was <font>
<p>postgresql-9.3.0-1-windows.exe </p>
<p>and this=A0email refers to=A0the documentation that came with that packa=
ge.</p></font></div>
<div>=A0</div>
<div>I started reading the documentation today for pgAdmin III 1.18.0 as it=
 seems that I must use pgAdmin III in order to get any work done.=A0 I have=
 only read about a dozen pages before becoming overloaded.=A0 With the exce=
ption of changing the passworld, I have no idea what I read means, nor the =
significance of any of it.=A0 I would think that it would be more helpful t=
o either explain what you are expected to already know before being able to=
 use the documentation, or, (more skillfully), put links=A0that explain wha=
t each technical term means, and/or what relevance/consequence each decisio=
n you make has.=A0 </div>

<div>=A0</div>
<div>Otherwise, I have no idea when or where I will ever run into that part=
icular jargon ever again, and the wondrous possibility that context will su=
ddenly make things clear that were obscure the first time around.</div>

<div>=A0</div>
<div>Mostly, I just wanted to point out that there are an absolutely incred=
ible number of typos on the very few pages that I have slogged through so f=
ar.=A0 It is clear that nobody has read this documentation in ages, as it w=
ould be impossible for any alert human being to miss them.=A0 I imagine tha=
t most of them are a result of prior editing, and that the final result mig=
ht actually be better than the previous version of the documentation, but t=
here can be no excuse for failing to run any prepared text through a spell =
checker, which would catch a large number of the typos.=A0 </div>

<div>=A0</div>
<div>I would be happy to provide at least some editing services as my contr=
ibution to the project, (being absolutely ignorant of anything actually use=
ful), provided there was some guarantee that they would actually be impleme=
nted or otherwise used.</div>

<div>=A0</div>
<div>I would have to be told exactly how to go about making changes in a wa=
y that would be considered useful.=A0 I am guessing that merely submitting =
a list of=A0the text with typos and providing my suggested corrections woul=
d likely not be input, as this work is very boring for most people.</div>

<div>=A0</div>
<div>Thanks for your consideration,</div>
<div>=A0</div>
<div>Barry Gysbers</div>
<div>=A0</div>

--047d7bf109fefd170304ef4f9cf7--