Re: Documentation and explanatory diagrams

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>
Cc: Greg Smith <greg(at)2ndquadrant(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documentation and explanatory diagrams
Date: 2010-04-14 01:02:09
Message-ID: 201004140102.o3E129n06944@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Rafael Martinez wrote:
> > Given that's how the work is being done by community members right now,
> > I think you'd make better progress asking how to index the material in
> > those slides better and provide a hotlist of good slides on the Wiki. I
> > consider fighting the battle to get the diagrams directly into the docs
> > the way it would need to be done to be both impractical and a waste of
> > resources, given many of these diagrams do already exist (and new ones
> > are constantly generated) if you follow the presentation scene.
> >
>
> I still think that the right place to have explanatory diagrams is in
> the official documentation and not a wiki or external document with
> pointers to other documents/presentations.
>
> They would make some important parts of the documentation much more
> easier to understand. This is especially important for new users of
> PostgreSQL and users who are trying to get an overview of PostgreSQL in
> a evaluation process.
>
> I know that most contributors have more than enough to do with the new
> release, and I don't want to create more work at this time. So maybe it
> will be better to fight this battle after 9.0 is released. :-)

OK, DIA sounds like it meets the requirements, and it would be good to
get some images into our documentation. I wonder if it could import
some of my xfig diagrams; if so, I could probably keep the images you
took from me updated in CVS.

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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2010-04-14 01:11:17 Re: code example wrapping
Previous Message Alvaro Herrera 2010-04-13 22:15:23 Re: docs cleanup patch