DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=message-id:date:from:to:cc:subject:references:mime-version
	:content-type:content-disposition:in-reply-to:user-agent;
	b=Pu7QxHer4obIv9gWzEmsuz0d50+H6NNhobJM8hZrAEG0K9MN6vXKBngkSHQjzA2pUu
	+6tizujIh04jBDZQkrRVNnAGCF64mlEUPFxfSaxaXN4Pc76LS+BtzkLK8M4LfRbQIxq7
	3mFNeJT6F6AOeUzw01PtpmCQ0CsHjE5M6kk+8=
Message-ID: <4bffced3.8c43e70a.68d9.64ee@mx.google.com>
Date: Fri, 28 May 2010 08:10:24 -0600
From: Joshua Tolley <eggyknap@gmail.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: Stefan Kaltenbrunner <stefan@kaltenbrunner.cc>,
	Robert Haas <robertmhaas@gmail.com>,
	Francisco Reyes <lists@stringsutils.com>,
	Greg Sabino Mullane <greg@turnstep.com>, pgsql-docs@postgresql.org
Subject: Re: Londiste
References: <4BFEDF29.3040908@kaltenbrunner.cc>
	<201005280314.o4S3EmI22630@momjian.us>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="d6Gm4EdcadzBjdND"
Content-Disposition: inline
In-Reply-To: <201005280314.o4S3EmI22630@momjian.us>
User-Agent: Mutt/1.5.18 (2008-05-17)


--d6Gm4EdcadzBjdND
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, May 27, 2010 at 11:14:48PM -0400, Bruce Momjian wrote:
> Stefan Kaltenbrunner wrote:
> > > The point is that there is a lot of replication information I don't w=
ant
> > > to merge into that SGML page so even if we mention "Londiste", the wi=
ki
> > > reference is still useful.  I have the same problem with mentioning
> > > pooling in the docs --- there is no natural place to put it, but I can
> > > reference the wiki from the performance SGML docs.
> >=20
> > well the problem seems to be that we are basically trying to recreate=
=20
> > the stuff on the wiki in the main docs in a way that might end up in=20
> > being outdated all the time.
> > I think that we need to draw a clear line where we do external links=20
> > (random sites or the wiki) and internal docs. everything that is the=20
> > core product needs to be in the main docs if we go above that (and that=
=20
> > includes all the replication stuff and whatnot) we should just referenc=
e=20
> > an external source (wiki.postgresql.org prefered - fallback to somethin=
g=20
> > else) but maintaining just some stuff in our own docs seems just wrong.=
=2E.
>=20
> Yea, the wiki information is far too bulky to fit into our docs, and
> maintaining it in our docs isn't worthwhile because it is more
> _suggestions_ than critical information.

Perhaps the docs should just say exactly that:

The PostgreSQL community has developed a wide variety of additional software
and made it available for general use. This documentation describes only the
software in the "core" PostgreSQL distribution (comprising the server, a set
of client programs, and the contrib packages), and does not attempt to
document this additional software in any detail. Interested readers are
advised to consult the PostgreSQL wiki at http://wiki.postgresql.org for
further details

ISTM there's a page somewhere on the wiki that tries to be a comprehensive
listing of add-ons, but I can't find it. Maybe that page ought to get speci=
al
mention in such documentation.

--
Joshua Tolley / eggyknap
End Point Corporation
http://www.endpoint.com

--d6Gm4EdcadzBjdND
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkv/ztAACgkQRiRfCGf1UMPgCACgn9AcxSeM6tg2/sZ2G9LXUY5w
M9wAn1H61vM2E5Xx5RlGtwyZ8ZweF2iW
=FAQ2
-----END PGP SIGNATURE-----

--d6Gm4EdcadzBjdND--