Re: TODO, FAQs to Wiki? - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: TODO, FAQs to Wiki?
Date
Msg-id 20080421152005.201b07c7@mha-laptop
Whole thread Raw
In response to Re: TODO, FAQs to Wiki?  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: TODO, FAQs to Wiki?  (Alvaro Herrera <alvherre@commandprompt.com>)
Re: TODO, FAQs to Wiki?  ("Brendan Jurd" <direvus@gmail.com>)
Re: TODO, FAQs to Wiki?  (Peter Eisentraut <peter_e@gmx.net>)
Re: TODO, FAQs to Wiki?  (Bruce Momjian <bruce@momjian.us>)
List pgsql-hackers
Peter Eisentraut wrote:
> Am Samstag, 19. April 2008 schrieb Alvaro Herrera:
> > The FAQs are another matter however.  I suggested some time back
> > moving those to DocBook XML.
>
> The question is whether we consider the FAQ to be a document tied to
> a PostgreSQL release (e.g., there is a separate FAQ applying to each
> release) or whether it is a "global" document.  In the former case,
> it should be in CVS, in the latter it should be somewhere else.  In
> my mind, it is quite clear that it is the latter.

Agreed. I don't think we *ever* backpatch FAQ stuff, which is a clear
indicator it's the later.


> But while I am in favor of moving as much as possible of the
> developer documentation to the wiki, I am not sure such a primary,
> user-facing document should be in a wiki.  Not because I am afraid of
> anyone being able to edit it, but I am concerned about the impression
> this creates with (new) users. Could we mirror it from the wiki to
> the "real" web site?

I'm sure we can find a way to do that. We do a lot of fairly ugly work
to mirror from the cvs tree to the website today...

For reference, the developer FAQ (which really is a different thing,
given the audience) now lives on the wiki at
http://wiki.postgresql.org/wiki/Developer_FAQ. I'd like to hear what
people think about that one, and get a "signoff" on if this should be
the main location for it, thus removing it from CVS. (We've already had
a couple of fixes go into it, so it's actually more up-to-date than the
one in CVS...)

//Magnus


pgsql-hackers by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: TODO, FAQs to Wiki?
Next
From: Magnus Hagander
Date:
Subject: pgstat SRF?