Re: Documentation and explanatory diagrams

From: Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>
To: Greg Smith <greg(at)2ndquadrant(dot)com>
Cc: 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-05 22:59:51
Message-ID: 4BBA6B67.5060400@usit.uio.no
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Greg Smith 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. :-)

regards
- --
Rafael Martinez, <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>
Center for Information Technology Services
University of Oslo, Norway

PGP Public Key: http://folk.uio.no/rafael/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAku6a1gACgkQBhuKQurGihTJjgCgjaCCkghoP8vr1auJJKwczM/4
EIMAnAsRhFfgj9pIG3hR6fsG0Bw8LjWa
=lkA6
-----END PGP SIGNATURE-----

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Erik Rijkers 2010-04-06 00:43:32 Re: code example wrapping
Previous Message Rafael Martinez 2010-04-05 22:58:27 Re: Documentation and explanatory diagrams