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

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

From: Oleg Bartunov <oleg(at)sai(dot)msu(dot)su>
To: Kevin Hunter <hunteke(at)earlham(dot)edu>
Cc: Nikolay Samokhvalov <nikolay(at)samokhvalov(dot)com>, Magnus Hagander <magnus(at)hagander(dot)net>, Alvaro Herrera <alvherre(at)commandprompt(dot)com>, PostgreSQL WWW List <pgsql-www(at)postgresql(dot)org>, PostgreSQL Documentation List <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?
Date: 2007-06-08 12:41:48
Message-ID: Pine.LNX.4.64.0706081635050.2951@sn.sai.msu.ru (view raw or flat)
Thread:
Lists: pgsql-docspgsql-www
The possible solution would be a forum with specific page as 
an originated message and users comments as a thread messages.
We use this approach for many years.

Oleg
On Fri, 8 Jun 2007, Kevin Hunter wrote:

> At 5:18p -0400 on 07 Jun 2007, Nikolay Samokhvalov wrote:
>
>> But I suppose there are some cases when it's not possible to move the
>> comment to the main text -- e.g. if the comment concerns too narrow
>> area, is very specific and is useful not for all people (but still
>> useful for some!).
>> 
>> Moreover, moving good comments to the main text makes the text bloated
>> -- what if we have 10 examples of using function aaa() and all of them
>> are illustrations for different areas? We (ok, sorry, Tom because only
>> he knows English) will choose only 1 of them to avoid bloating of the
>> main text, even if all 10 use cases has some specific features...
>
> Hrm.  If they're still good comments, what about including a hyperlink to a 
> pop-up or separate page with some specific information about that particular 
> point?  ("There is more <a href='popup'>discussion on the many uses of the 
> function aaa()</a>")  Bloat for the main documentation could still avoided, 
> but if read on-line (as the docs are meant to be read?) then access to 
> other's wisdom need not lost/weeded out.
>
>> I could help with (yeah, not with reworking comments -- I do not know
>> English well :-) ) creating a simple patch that adds a notice "this
>> comment was originally created for version 8.0" and maybe something
>
> Although, short of above, perhaps this'd be an easier en masse solution?
>
>> BTW, then we would add some marking/rating system to the comments to allow 
>> other users see what comment is really useful.
>
> Kind of like digg or something?  Where the higher-rated float to the top?
>
> Kevin
>
> ---------------------------(end of broadcast)---------------------------
> TIP 1: if posting/reading through Usenet, please send an appropriate
>     subscribe-nomail command to majordomo(at)postgresql(dot)org so that your
>     message can get through to the mailing list cleanly

 	Regards,
 		Oleg
_____________________________________________________________
Oleg Bartunov, Research Scientist, Head of AstroNet (www.astronet.ru),
Sternberg Astronomical Institute, Moscow University, Russia
Internet: oleg(at)sai(dot)msu(dot)su, http://www.sai.msu.su/~megera/
phone: +007(495)939-16-83, +007(495)939-23-83

In response to

pgsql-docs by date

Next:From: Campbell, LanceDate: 2007-06-18 15:04:15
Subject: Volunteer to build a configuration tool
Previous:From: Kevin HunterDate: 2007-06-08 11:56:33
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?

pgsql-www by date

Next:From: Andrew SullivanDate: 2007-06-08 14:33:39
Subject: various spam
Previous:From: Kevin HunterDate: 2007-06-08 11:56:33
Subject: Re: [DOCS] Users comments don't migrate to docs for new version?

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