From: | Magnus Hagander <magnus(at)hagander(dot)net> |
---|---|
To: | Jim Nasby <decibel(at)decibel(dot)org> |
Cc: | Alvaro Herrera <alvherre(at)commandprompt(dot)com>, 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-07-11 17:51:45 |
Message-ID: | 469518B1.6050309@hagander.net |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-www |
Jim Nasby wrote:
> On Jun 6, 2007, at 2:18 PM, 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!
>
> It would be substantially easier to do that if there was an index page
> that listed all comments.
There is supposed to be one in the admin interface. But it seems I broke
that with the latest update :-)
Are you volunteering for doing some work on it? If so, I'm going to
increase the priority of fixing that :-)
//Magnus
From | Date | Subject | |
---|---|---|---|
Next Message | Jim Nasby | 2007-07-13 06:03:30 | Re: [DOCS] Users comments don't migrate to docs for new version? |
Previous Message | Jim Nasby | 2007-07-11 17:49:44 | Re: [DOCS] Users comments don't migrate to docs for new version? |
From | Date | Subject | |
---|---|---|---|
Next Message | Jim Nasby | 2007-07-13 06:03:30 | Re: [DOCS] Users comments don't migrate to docs for new version? |
Previous Message | Jim Nasby | 2007-07-11 17:49:44 | Re: [DOCS] Users comments don't migrate to docs for new version? |