Replication Documentation

Lists: pgsql-docs
From: Markus Schiltknecht <markus(at)bluegap(dot)ch>
To: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>
Subject: Replication Documentation
Date: 2006-08-21 13:47:09
Message-ID: 44E9B95D.1030209@bluegap.ch
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Hi,

has there been a consensus about where a replication document should go
and what it should cover?

Regards

Markus


From: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>
To: pgsql-docs(at)postgresql(dot)org
Cc: Markus Schiltknecht <markus(at)bluegap(dot)ch>, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>
Subject: Re: Replication Documentation
Date: 2006-08-27 19:39:08
Message-ID: 200608271539.09297.xzilla@users.sourceforge.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

On Monday 21 August 2006 09:47, Markus Schiltknecht wrote:
> Hi,
>
> has there been a consensus about where a replication document should go
> and what it should cover?
>

I think the general idea is to toss it on techdocs... like the GUI Tools
page... http://www.postgresql.org/docs/techdocs.54

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


From: Markus Schiltknecht <markus(at)bluegap(dot)ch>
To: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>
Cc: pgsql-docs(at)postgresql(dot)org, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>, pgman(at)candle(dot)pha(dot)pa(dot)us
Subject: Re: Replication Documentation
Date: 2006-08-28 09:07:14
Message-ID: 44F2B242.60807@bluegap.ch
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Robert Treat wrote:
> On Monday 21 August 2006 09:47, Markus Schiltknecht wrote:
>> has there been a consensus about where a replication document should go
>> and what it should cover?
>
> I think the general idea is to toss it on techdocs... like the GUI Tools
> page... http://www.postgresql.org/docs/techdocs.54

Hm. I didn't know that one. There is already a section about
replication. Chris, do you agree to put your article there?

But AFAIK the goal of our discussion was to put _something_ into the
official documentation to make it better visible. Lots of people ask for
replication solutions, but up to now there is no official statement. So
newcomers need to google around, figure out about lots of different
projects, partly dead ones, etc...

If we put an extensive replication article in the techdocs, we need to
link it somehow from the main documentatino, IMHO. Otherwise it probably
won't help that much.

Regards

Markus


From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Markus Schiltknecht <markus(at)bluegap(dot)ch>
Cc: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>, pgsql-docs(at)postgresql(dot)org, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>, pgman(at)candle(dot)pha(dot)pa(dot)us
Subject: Re: Replication Documentation
Date: 2006-08-28 14:48:53
Message-ID: 200608281448.k7SEmrv04306@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Markus Schiltknecht wrote:
> Robert Treat wrote:
> > On Monday 21 August 2006 09:47, Markus Schiltknecht wrote:
> >> has there been a consensus about where a replication document should go
> >> and what it should cover?
> >
> > I think the general idea is to toss it on techdocs... like the GUI Tools
> > page... http://www.postgresql.org/docs/techdocs.54
>
> Hm. I didn't know that one. There is already a section about
> replication. Chris, do you agree to put your article there?
>
> But AFAIK the goal of our discussion was to put _something_ into the
> official documentation to make it better visible. Lots of people ask for
> replication solutions, but up to now there is no official statement. So
> newcomers need to google around, figure out about lots of different
> projects, partly dead ones, etc...
>
> If we put an extensive replication article in the techdocs, we need to
> link it somehow from the main documentatino, IMHO. Otherwise it probably
> won't help that much.

I will work on a replication section for 8.2, similar to the XML docs I
posted a few days ago.

--
Bruce Momjian bruce(at)momjian(dot)us
EnterpriseDB http://www.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +


From: Markus Schiltknecht <markus(at)bluegap(dot)ch>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>, pgsql-docs(at)postgresql(dot)org, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>, pgman(at)candle(dot)pha(dot)pa(dot)us
Subject: Re: Replication Documentation
Date: 2006-08-28 17:36:58
Message-ID: 44F329BA.5080107@bluegap.ch
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Bruce Momjian wrote:
> I will work on a replication section for 8.2, similar to the XML docs I
> posted a few days ago.

Okay, great! You have Christopher's draft [1]? How much information do
you want to include into the main documentation? Do you want to put some
more details to the techdocs?

Regards

Markus

[1]: http://archives.postgresql.org/pgsql-patches/2006-08/msg00026.php


From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Markus Schiltknecht <markus(at)bluegap(dot)ch>
Cc: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>, pgsql-docs(at)postgresql(dot)org, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>, pgman(at)candle(dot)pha(dot)pa(dot)us
Subject: Re: Replication Documentation
Date: 2006-08-28 19:48:15
Message-ID: 200608281948.k7SJmFJ26139@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Markus Schiltknecht wrote:
> Bruce Momjian wrote:
> > I will work on a replication section for 8.2, similar to the XML docs I
> > posted a few days ago.
>
> Okay, great! You have Christopher's draft [1]? How much information do
> you want to include into the main documentation? Do you want to put some
> more details to the techdocs?

My content will be more general. I will post to the docs list when it
is ready for review.

--
Bruce Momjian bruce(at)momjian(dot)us
EnterpriseDB http://www.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +


From: Markus Schiltknecht <markus(at)bluegap(dot)ch>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>, pgsql-docs(at)postgresql(dot)org, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>, pgman(at)candle(dot)pha(dot)pa(dot)us
Subject: Re: Replication Documentation
Date: 2006-08-28 20:18:21
Message-ID: 44F34F8D.90400@bluegap.ch
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Bruce Momjian wrote:
> My content will be more general.

That sounds good to me.

Shall we put more details into the techdocs, then? Or do you want to
leave it up to every single project to better document itself?

> I will post to the docs list when it
> is ready for review.

Great. I'll be on vacation until September, 6th, so you can be assured
to not get any dumb comments from me until that date. ;-)

Regards

Markus


From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Markus Schiltknecht <markus(at)bluegap(dot)ch>
Cc: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>, pgsql-docs(at)postgresql(dot)org, Peter Eisentraut <peter_e(at)gmx(dot)net>, Chris Browne <cbbrowne(at)acm(dot)org>, pgman(at)candle(dot)pha(dot)pa(dot)us
Subject: Re: Replication Documentation
Date: 2006-08-28 22:36:00
Message-ID: 200608282236.k7SMa0R15682@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Markus Schiltknecht wrote:
> Bruce Momjian wrote:
> > My content will be more general.
>
> That sounds good to me.
>
> Shall we put more details into the techdocs, then? Or do you want to
> leave it up to every single project to better document itself?

It will go in the PostgreSQL project SGML docs.

--
Bruce Momjian bruce(at)momjian(dot)us
EnterpriseDB http://www.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +