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

Re: [HACKERS] Contrib modules documentation online

From: Decibel! <decibel(at)decibel(dot)org>
To: Josh Berkus <josh(at)agliodbs(dot)com>
Cc: pgsql-hackers(at)postgresql(dot)org,Albert Cervera i Areny <albert(at)nan-tic(dot)com>,pgsql-docs(at)postgresql(dot)org
Subject: Re: [HACKERS] Contrib modules documentation online
Date: 2007-08-29 17:43:39
Message-ID: 20070829174339.GJ1386@nasby.net (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackers
On Wed, Aug 29, 2007 at 10:09:07AM -0700, Josh Berkus wrote:
> Albert,
> 
> (crossed over to -docs, where it really belongs)
> 
> > I've been working on converting the current README files for all contrib
> > modules into sgml and add it to the documentation. There are still some
> > fixes to do but i'd like to have some feedback. Indeed, it wasn't agreed to
> > have all if any of the modules together with the core documentation.
> >
> > You can see the docs on [1] in chapter VIII. If you think these could be a
> > good addition, please fill free to comment on how you think sections should
> > be organized to be consistent and easy to read.
> >
> > [1] http://www.nan-tic.com/ftp/pgdoc
> 
> Wow, this is really, really cool!  You're my hero.
> 
> I'm very strongly in favor of having this documentation.  However, I think it 
> might make sense to put "Contrib Modules" as a section under either 
> "Reference" or "Appendices".  Also, I don't think it's necessary to make each 
> command option a separate subchapter, but I can see how that would be hard to 
> avoid in an automated system.  
> 
> Guys, would it be out of the question to do this in 8.3?  Please please?
> 
> If we go ahead with this, I'll commit to doing a contrib README cleanup so the 
> doc system works better.

One question... would there still be a README in each contrib directory?
I think getting this stuff in the docs is great, but the README in the
source is also very valuable and I'd hate to lose it.
-- 
Decibel!, aka Jim Nasby                        decibel(at)decibel(dot)org
EnterpriseDB      http://enterprisedb.com      512.569.9461 (cell)

In response to

pgsql-docs by date

Next:From: Tom LaneDate: 2007-08-29 17:53:21
Subject: Re: [HACKERS] Contrib modules documentation online
Previous:From: Josh BerkusDate: 2007-08-29 17:09:07
Subject: Re: [HACKERS] Contrib modules documentation online

pgsql-hackers by date

Next:From: Tom LaneDate: 2007-08-29 17:53:21
Subject: Re: [HACKERS] Contrib modules documentation online
Previous:From: Florian G. PflugDate: 2007-08-29 17:32:00
Subject: Advice on MyXactMade* flags, MyLastRecPtr, pendingDeletes and lazy XID assignment

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