Re: Documentation and explanatory diagrams - Mailing list pgsql-docs

From Rafael Martinez
Subject Re: Documentation and explanatory diagrams
Date
Msg-id 4BBA6B67.5060400@usit.uio.no
Whole thread Raw
In response to Re: Documentation and explanatory diagrams  (Greg Smith <greg@2ndquadrant.com>)
Responses Re: Documentation and explanatory diagrams
List 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.m.guerrero@usit.uio.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-----

pgsql-docs by date:

Previous
From: Rafael Martinez
Date:
Subject: Re: Documentation and explanatory diagrams
Next
From: "Erik Rijkers"
Date:
Subject: Re: code example wrapping