Re: Missing link in Developer FAQ - Mailing list pgsql-www

From Alvaro Herrera
Subject Re: Missing link in Developer FAQ
Date
Msg-id 1345731608-sup-7687@alvh.no-ip.org
Whole thread Raw
In response to Re: Missing link in Developer FAQ  (Magnus Hagander <magnus@hagander.net>)
Responses Re: Missing link in Developer FAQ
List pgsql-www
Excerpts from Magnus Hagander's message of jue ago 23 06:34:53 -0400 2012:
> On Wed, Aug 22, 2012 at 5:38 PM, Alvaro Herrera
> <alvherre@2ndquadrant.com> wrote:

> I'm pretty sure that's what we decided when migrating to the new
> website, so it was dropped intentionally. But I can't actually find a
> reference to the discussion.
>
> I think one thing discussed was that the source tree is really a bad
> place to store it. The entire contents, including images, should
> probably be migrated to the wiki instead. *or* to the "website
> proper", but in that case in the actual website SCM, not in the
> postgresql.git one.

That's what I said four years ago.  People weren't excited about that
idea because "there would be no way for it to be in sync with each
different release, only HEAD".  I think it's time to let go of that
thought and move it to the wiki or website, where we would (try to)
ensure that it documents the current development version.  There doesn't
seem to be any point to keeping multiple versions of it; would-be
developers (the intended audience) are all trying to understand *that*
version, after all, not the previous ones.

> Also, it took almost a year for anybody to notice that they weren't
> there, so they're clearly not used very much.

I think it's not visible enough.  We have plenty of new people trying to
understand the PG innards all the time that it remains a useful
resource.

That's my opinion anyway.

--
Álvaro Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services



pgsql-www by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: Missing link in Developer FAQ
Next
From: Josh Berkus
Date:
Subject: SSH keys wiped out?