Thread: About Page Draft

About Page Draft

From
Michael Owens
Date:
Hey all,

A couple of weeks ago I started putting together some general text for
the About Page. No one asked me to do it, and it's not perfect, and
certainly you don't have to use it, but it interested me and I just
thought I would try to do what I could to help out.

I dug through various stuff in the docs and on the net, and lifted out
everything I could. I think most of the historical stuff is accurate
although I've seen different takes on what exactly went into Informix
(thought some references mentioned Ingres rather than Postgres).

Anyway, if this is helpful, I'll keep working on it and try to get it
more presentable. Any ideas and suggestions are welcome.

Also, I want to thank you guys and everyone involved for creating such
a terrific project. I've used a lot of databases, and PostgreSQL is by
far the all around best.

The draft is at http://www.gintana.com/pgsql/.

-- Mike

Re: About Page Draft

From
Josh Berkus
Date:
Michael,

> A couple of weeks ago I started putting together some general text for
> the About Page. No one asked me to do it, and it's not perfect, and
> certainly you don't have to use it, but it interested me and I just
> thought I would try to do what I could to help out.

Wow, nice!   Thanks so much for doing this, it's worlds of improvement over
our old Advocacy text.  Really nice.

> Anyway, if this is helpful, I'll keep working on it and try to get it
> more presentable. Any ideas and suggestions are welcome.

Some suggestions:
1) we'll want to break this up into several HTML pages.   It's too much text
for one screen.    Can you do a table of contents for it?

2) Drop "Hash" from the list of indexes.   While we do support them, we
specifically recommend against them in the docs.

3) "belonging to it" is spelled "its" not "it's" -- at least, in American and
British English.  More copy-edits later.

Thanks again, this will help the new site a lot!

--Josh

--
__Aglio Database Solutions_______________
Josh Berkus               Consultant
josh@agliodbs.com     www.agliodbs.com
Ph: 415-752-2500    Fax: 415-752-2387
2166 Hayes Suite 200    San Francisco, CA

Re: About Page Draft

From
Tom Lane
Date:
Josh Berkus <josh@agliodbs.com> writes:
> Michael,
>> A couple of weeks ago I started putting together some general text for
>> the About Page. No one asked me to do it, and it's not perfect, and
>> certainly you don't have to use it, but it interested me and I just
>> thought I would try to do what I could to help out.

> Wow, nice!   Thanks so much for doing this, it's worlds of improvement over
> our old Advocacy text.  Really nice.

Yeah, it looks great.  I looked through it for technical errors and
didn't find much of anything wrong.  One point is that the FAQ lists the
max table size as 32TB not 16TB.  The issue there is whether BlockNumber
is treated as unsigned everywhere it needs to be.  I believe that it is,
but I haven't heard from anyone who's actually tested tables > 16TB ...

Also, you should probably not list me as one of the "original"
major developers; the other four came several years before I did.

> 2) Drop "Hash" from the list of indexes.   While we do support them, we
> specifically recommend against them in the docs.

I disagree with this.  It's in the code and the docs; it will look like
an omission if it's not listed.

> More copy-edits later.

It does need spelling and copyedit work, but that's no problem.

Nice work ... thanks again!

            regards, tom lane

Re: About Page Draft

From
Oleg Bartunov
Date:
Mike,

this is great !  I don't know how detailed your document would be, so
I just point you to GiST introduction
http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml
AFAIK, postgres has first implementation of such structures.

     Oleg
On Sat, 15 Jan 2005, Michael Owens wrote:

> Hey all,
>
> A couple of weeks ago I started putting together some general text for
> the About Page. No one asked me to do it, and it's not perfect, and
> certainly you don't have to use it, but it interested me and I just
> thought I would try to do what I could to help out.
>
> I dug through various stuff in the docs and on the net, and lifted out
> everything I could. I think most of the historical stuff is accurate
> although I've seen different takes on what exactly went into Informix
> (thought some references mentioned Ingres rather than Postgres).
>
> Anyway, if this is helpful, I'll keep working on it and try to get it
> more presentable. Any ideas and suggestions are welcome.
>
> Also, I want to thank you guys and everyone involved for creating such
> a terrific project. I've used a lot of databases, and PostgreSQL is by
> far the all around best.
>
> The draft is at http://www.gintana.com/pgsql/.
>
> -- Mike
>
> ---------------------------(end of broadcast)---------------------------
> TIP 6: Have you searched our list archives?
>
>               http://archives.postgresql.org
>

     Regards,
         Oleg
_____________________________________________________________
Oleg Bartunov, sci.researcher, hostmaster of AstroNet,
Sternberg Astronomical Institute, Moscow University (Russia)
Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
phone: +007(095)939-16-83, +007(095)939-23-83

Re: About Page Draft

From
Michael Owens
Date:
Okay, I added some info on GiST under the features section. See what
you think. I tried to make it as technically correct as I could, but
feel free to correct me. I still have to have my wife (the smarter
half) look it over for spelling/grammer. Any suggestions on any part,
just let me know.

-- Mike


On Sun, 16 Jan 2005 22:44:01 +0300 (MSK), Oleg Bartunov <oleg@sai.msu.su> wrote:
> Mike,
>
> this is great !  I don't know how detailed your document would be, so
> I just point you to GiST introduction
> http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml
> AFAIK, postgres has first implementation of such structures.
>
>         Oleg
> On Sat, 15 Jan 2005, Michael Owens wrote:
>
> > Hey all,
> >
> > A couple of weeks ago I started putting together some general text for
> > the About Page. No one asked me to do it, and it's not perfect, and
> > certainly you don't have to use it, but it interested me and I just
> > thought I would try to do what I could to help out.
> >
> > I dug through various stuff in the docs and on the net, and lifted out
> > everything I could. I think most of the historical stuff is accurate
> > although I've seen different takes on what exactly went into Informix
> > (thought some references mentioned Ingres rather than Postgres).
> >
> > Anyway, if this is helpful, I'll keep working on it and try to get it
> > more presentable. Any ideas and suggestions are welcome.
> >
> > Also, I want to thank you guys and everyone involved for creating such
> > a terrific project. I've used a lot of databases, and PostgreSQL is by
> > far the all around best.
> >
> > The draft is at http://www.gintana.com/pgsql/.
> >
> > -- Mike
> >
> > ---------------------------(end of broadcast)---------------------------
> > TIP 6: Have you searched our list archives?
> >
> >               http://archives.postgresql.org
> >
>
>         Regards,
>                 Oleg
> _____________________________________________________________
> Oleg Bartunov, sci.researcher, hostmaster of AstroNet,
> Sternberg Astronomical Institute, Moscow University (Russia)
> Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
> phone: +007(095)939-16-83, +007(095)939-23-83
>

Re: About Page Draft

From
Adrian Maier
Date:
On Sun, 16 Jan 2005 15:01:47 -0600, Michael Owens <mikeowens@gmail.com> wrote:
> Okay, I added some info on GiST under the features section. See what
> you think. I tried to make it as technically correct as I could, but
> feel free to correct me. I still have to have my wife (the smarter
> half) look it over for spelling/grammer. Any suggestions on any part,
> just let me know.

In the "Highly customizable" page, in the first line,  the name of the
language it think that it should be "PL/pgSQL",   not  "PG/PSQL".


Cheers,
Adrian Maier