Re: [DOCS] Users comments don't migrate to docs for new version?

From: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: nikolay(at)samokhvalov(dot)com, pgsql-www(at)postgresql(dot)org, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Date: 2007-06-06 19:40:15
Message-ID: 20070606194015.GG11800@alvh.no-ip.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

Magnus Hagander wrote:
> Alvaro Herrera wrote:
> > Nikolay Samokhvalov wrote:
> >> I've just found (via google...) useful (for me) comments:
> >> http://www.postgresql.org/docs/8.0/interactive/sql-createaggregate.html
> >> -- I mean users comments under primary contents of the page.
> >>
> >> These comments were written for 8.0, but are useful for the current
> >> versions too. What we have is the situation that reading docs for 8.2
> >> people don't see these comments -- so this potentially useful
> >> information is lost. So, in this implementation the idea of comments
> >> for docs becomes weak in general.
> >
> > The thing to do in these cases is to move the useful info from the user
> > comments into the main doc text.
>
> Yeah, that's the idea. Tom often goes through the comments and puts
> stuff into the docs. But I'm sure there are a *lot* of other people who
> could help with that as well - read comments, figure out of they make
> sense, and submit a docs patch for the next version!

Other people!?!?!? What are you thinking -- why would _anyone_ spend
any effort in this, if Tom can make all the work for us??? No one else
needs to bother!!! Surely Tom is the only person on earth who knows how
to write proper english anyway.

--
Alvaro Herrera http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Nikolay Samokhvalov 2007-06-07 06:10:19 Re: [DOCS] Users comments don't migrate to docs for new version?
Previous Message Magnus Hagander 2007-06-06 19:18:29 Re: [DOCS] Users comments don't migrate to docs for new version?

Browse pgsql-www by date

  From Date Subject
Next Message Mohsen Pahlevanzadeh 2007-06-07 00:27:29 webmaster & PersianPUG
Previous Message Magnus Hagander 2007-06-06 19:18:29 Re: [DOCS] Users comments don't migrate to docs for new version?