Re: TODO, FAQs to Wiki?

From: Magnus Hagander <magnus(at)hagander(dot)net>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-hackers(at)postgresql(dot)org, Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>
Subject: Re: TODO, FAQs to Wiki?
Date: 2008-04-21 13:20:05
Message-ID: 20080421152005.201b07c7@mha-laptop
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Magnus Hagander 2008-04-21 13:34:23 pgstat SRF?
Previous Message Magnus Hagander 2008-04-21 13:17:21 Re: TODO, FAQs to Wiki?