Re: Users comments don't migrate to docs for new version? - Mailing list pgsql-www

From Alvaro Herrera
Subject Re: Users comments don't migrate to docs for new version?
Date
Msg-id 20070606164029.GB11800@alvh.no-ip.org
Whole thread Raw
In response to Users comments don't migrate to docs for new version?  ("Nikolay Samokhvalov" <samokhvalov@gmail.com>)
Responses Re: [DOCS] Users comments don't migrate to docs for new version?  (Magnus Hagander <magnus@hagander.net>)
List pgsql-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"

pgsql-www by date:

Previous
From: "Nikolay Samokhvalov"
Date:
Subject: Users comments don't migrate to docs for new version?
Next
From: Magnus Hagander
Date:
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?