| From: | Magnus Hagander <magnus(at)hagander(dot)net> |
|---|---|
| To: | Alvaro Herrera <alvherre(at)commandprompt(dot)com> |
| 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:18:29 |
| Message-ID: | 46670885.1050207@hagander.net |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs pgsql-www |
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!
//Magnus
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2007-06-06 19:40:15 | Re: [DOCS] Users comments don't migrate to docs for new version? |
| Previous Message | Alvaro Herrera | 2007-06-06 16:40:29 | Re: Users comments don't migrate to docs for new version? |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2007-06-06 19:40:15 | Re: [DOCS] Users comments don't migrate to docs for new version? |
| Previous Message | Alvaro Herrera | 2007-06-06 16:40:29 | Re: Users comments don't migrate to docs for new version? |