Re: Get docs for contrib on the web somewhere

On Friday 17 March 2006 13:40, David Fetter wrote:
> On Fri, Mar 17, 2006 at 12:22:44PM -0600, Jim C. Nasby wrote:
> > On Wed, Mar 08, 2006 at 02:05:44PM -0800, David Fetter wrote:
> > > On Wed, Mar 08, 2006 at 01:50:47PM -0600, Jim C. Nasby wrote:
> > > > It would be nice if there was an easy place to see the documentation
> > > > for the various contrib projects. Would this be hard to setup? I
> > > > think the plain text would be fine, just need to post the readme's
> > > > somewhere and link to them.
> > >
> > > http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/ has at least
> > > the raw files. I'd be delighted to put up something more, tho :)
> >
> > Yeah, but very few people would ever think to look in CVS for
> > documentation. I think it'd be much better if we could include the
> > README's in the documentation build process somehow...
>
> I'm all for it. Do you have an idea of how this might work? I
> suppose some kind of idiot conversion of READMEs to man pages might be
> appropriate. Dunno about what would happen on Windows. Um, help?
>

Could we require contrib authors to provide their documentation as sgml, and
then have the doc build process loop in each contrib module as an appendix
inside the official docs?

--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL