Thread: Replication Documentation
Hi, has there been a consensus about where a replication document should go and what it should cover? Regards Markus
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
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
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@momjian.us EnterpriseDB http://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. +
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
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@momjian.us EnterpriseDB http://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. +
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
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@momjian.us EnterpriseDB http://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. +