pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedinteractive docs
4+ messages / 3 participants
[nested] [flat]
* interactive docs
@ 2002-01-12 01:22 Elein <elein@nextbus.com>
2002-01-14 20:04 ` Re: interactive docs Vince Vielhaber <vev@michvhf.com>
2002-01-15 06:19 ` Re: interactive docs Roberto Mello <rmello@cc.usu.edu>
0 siblings, 2 replies; 4+ messages in thread
From: Elein @ 2002-01-12 01:22 UTC (permalink / raw)
To: pgsql-docs; +Cc: elein@nextbus.com
As a wiki fan, I'm sorry to say I hate the interactive pages.
They are yet another forum for people who should be asking
questions in the mailing lists. They are very distracting.
If there were a genuine doc note in that mess, I would never
see it.
If you were to create a question/answer wiki it would probably
help a lot of people and ideally people would only really put doc
notes and examples on the interactive doc pages.
elein
--
Elein
elein@nextbus.com
ex-ingres, ex-illustra, ex-informix
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: interactive docs
2002-01-12 01:22 interactive docs Elein <elein@nextbus.com>
@ 2002-01-14 20:04 ` Vince Vielhaber <vev@michvhf.com>
1 sibling, 0 replies; 4+ messages in thread
From: Vince Vielhaber @ 2002-01-14 20:04 UTC (permalink / raw)
To: Elein <elein@nextbus.com>; +Cc: pgsql-docs
On Fri, 11 Jan 2002, Elein wrote:
>
> As a wiki fan, I'm sorry to say I hate the interactive pages.
> They are yet another forum for people who should be asking
> questions in the mailing lists. They are very distracting.
> If there were a genuine doc note in that mess, I would never
> see it.
The only reason it's not cleaned out is because when the release
finally occurs, the docnotes will be zeroed out since the important
stuff will already be in the docs.
BTW, there are other forms of documentation than the interactive.
Feel free to explore.
Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
56K Nationwide Dialup from $16.00/mo at Pop4 Networking
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: interactive docs
2002-01-12 01:22 interactive docs Elein <elein@nextbus.com>
@ 2002-01-15 06:19 ` Roberto Mello <rmello@cc.usu.edu>
2002-01-15 18:56 ` Re: interactive docs Elein <elein@nextbus.com>
1 sibling, 1 reply; 4+ messages in thread
From: Roberto Mello @ 2002-01-15 06:19 UTC (permalink / raw)
To: Elein <elein@nextbus.com>; +Cc: pgsql-docs
On Fri, Jan 11, 2002 at 05:22:40PM -0800, Elein wrote:
>
> As a wiki fan, I'm sorry to say I hate the interactive pages.
> They are yet another forum for people who should be asking
> questions in the mailing lists. They are very distracting.
> If there were a genuine doc note in that mess, I would never
> see it.
Are you volunteering to moderate doc notes? That would mean you'd have to
scan them once in a while and remove questions, directing questioners to
the lists.
> If you were to create a question/answer wiki it would probably
> help a lot of people and ideally people would only really put doc
> notes and examples on the interactive doc pages.
That's what mailing lists are for. Wikis have good uses, but so do mailing
lists.
-Roberto
--
+----| http://fslc.usu.edu/ USU Free Software & GNU/Linux Club |------+
Roberto Mello - Computer Science, USU - http://www.brasileiro.net/
http://www.sdl.usu.edu/ - Space Dynamics Lab, Developer
You just watch yourself. I have the death sentence in twelve systems.
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: interactive docs
2002-01-12 01:22 interactive docs Elein <elein@nextbus.com>
2002-01-15 06:19 ` Re: interactive docs Roberto Mello <rmello@cc.usu.edu>
@ 2002-01-15 18:56 ` Elein <elein@nextbus.com>
0 siblings, 0 replies; 4+ messages in thread
From: Elein @ 2002-01-15 18:56 UTC (permalink / raw)
To: Roberto Mello <rmello@cc.usu.edu>; +Cc: pgsql-docs
Roberto Mello wrote:
> On Fri, Jan 11, 2002 at 05:22:40PM -0800, Elein wrote:
>
>>As a wiki fan, I'm sorry to say I hate the interactive pages.
>>They are yet another forum for people who should be asking
>>questions in the mailing lists. They are very distracting.
>>If there were a genuine doc note in that mess, I would never
>>see it.
>>
>
> Are you volunteering to moderate doc notes? That would mean you'd have to
> scan them once in a while and remove questions, directing questioners to
> the lists.
>
>
>>If you were to create a question/answer wiki it would probably
>>help a lot of people and ideally people would only really put doc
>>notes and examples on the interactive doc pages.
>>
>
> That's what mailing lists are for. Wikis have good uses, but so do mailing
> lists.
>
> -Roberto
>
>
If I were not the only moderator, I certainly could help.
Tell me how to do it and I'll try to be nice :-) and be
as attentive as my work allows.
While you all are listening, I also have an organization
suggestion. List the functions that operate on a data
type with the data type. Just a returns,function(args)
list would probably do. I rarely look up a data type without
jumping over to functions. A list of the functions
gives people a better idea of the uses and limitations
of a given datatype. (I understand this suggestion is
probably too late to be useful to 7.2 docs)
cheers,
elein
--
--------------------------------------------------------
elein@nextbus.com
(510)420-3120
www.nextbus.com
spinning to infinity, hallelujah
--------------------------------------------------------
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2002-01-15 18:56 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2002-01-12 01:22 interactive docs Elein <elein@nextbus.com>
2002-01-14 20:04 ` Vince Vielhaber <vev@michvhf.com>
2002-01-15 06:19 ` Roberto Mello <rmello@cc.usu.edu>
2002-01-15 18:56 ` Elein <elein@nextbus.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox