Skip site navigation (1) Skip section navigation (2)

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

From: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
To: nikolay(at)samokhvalov(dot)com
Cc: pgsql-www(at)postgresql(dot)org, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Users comments don't migrate to docs for new version?
Date: 2007-06-06 16:40:29
Message-ID: 20070606164029.GB11800@alvh.no-ip.org (view raw or flat)
Thread:
Lists: pgsql-docspgsql-www
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.

-- 
Alvaro Herrera                        http://www.advogato.org/person/alvherre
"La victoria es para quien se atreve a estar solo"

In response to

Responses

pgsql-docs by date

Next:From: Magnus HaganderDate: 2007-06-06 19:18:29
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Previous:From: Christian RossowDate: 2007-06-06 16:33:36
Subject: Probably mistake in Arrays docs & proposal for index

pgsql-www by date

Next:From: Magnus HaganderDate: 2007-06-06 19:18:29
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Previous:From: Nikolay SamokhvalovDate: 2007-06-06 16:10:24
Subject: Users comments don't migrate to docs for new version?

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group